Repository navigation
Rythem v1.0.0
Release
Rythem v1.0.0-stable
Welcome to Rythem v1.0.0-stable — an ambient, milestone-driven learning operating system and curriculum orchestrator built with a local-first, zero-cloud architecture.
✨ Highlights & Core Capabilities
-
Effort Points System (1 Effort Point = 10 Minutes):
- Replaced raw beat counts with meaningful, time-scaled Effort Points throughout the entire application.
- Standalone video chapter effort calculation: dynamically computes exact chapter effort points using timestamp deltas
(nextChapterTimestamp - currentChapterTimestamp) / 10 min(or(videoDuration - currentChapterTimestamp) / 10 minfor the final chapter). - Multi-playlist video duration remapping with fast batch processing and duration normalization.
- Proportional effort point allocation for partial checkpoints (25%, 50%, 75%, 100%).
- 7-day metric performance graphs and calendar tiles display actual daily effort points instead of arbitrary beat counts.
-
Flag Notes & Doubt Tracking Notebook:
- Completely decoupled Flag Notes (doubts, confusion points, conceptual obstacles) from Checkpoints (topic completion percentage: 25%, 50%, 75%, 100%).
- Dedicated "Flag Notes" notebook tab in Explore with search, tag filters, and inline note previews.
- One-tap navigation from a flagged note directly into its roadmap and chapter context.
- Flag saving and editing uses an independent, dedicated pipeline; saving a flag displays contextual toast notifications ("Flag saved! 🚩" / "Flag removed") without modifying beat progress or clearing checkpoints.
-
Fluid Motion Design System & Liquid Aesthetics:
- Smooth page navigation transitions with cross-fading via
SharedAxisTransition/PageTransitionSwitcher. - Global iOS/macOS-style
BouncingScrollPhysicsacross all screens for silky, responsive scrolling. - Interactive frosted glass dialogs with smooth entry and exit scaling/fading (
SmoothDialog). - Integrated
flutter_animatewith test-safe central configuration (RythemMotion), floating dock rebounds, and staggered card entrances. - Monochrome liquid frosted glass design system with light and dark themes.
- Smooth page navigation transitions with cross-fading via
-
Resilient Data Vault & Local Backup:
- Unified Data Vault in Settings combining automated 7-day rolling local snapshots with manual native JSON export/import.
- Native Android storage permission bridge with fallback to application documents storage.
- Automated database linking, schema migrations, and backward-compatible snapshot discovery.
-
On-Device AI Models (100% Private & Local):
- Powered by local Small Language Models (Qwen 2.5 0.5B and 1.5B GGUF) for intelligent curriculum clustering and mentor Q&A without cloud dependencies.
- Resilient background model download manager with HTTP Range resumption and mutex protection.
- Stabilized initial onboarding and restart loop with immediate file verification.
-
Multi-Playlist & Resource Synchronization:
- Background resource synchronization engine that auto-refreshes video durations, metadata, and timestamps without freezing or timing out.
- Multi-renderer YouTube playlist and video extraction supporting unbounded playlists and mobile share sheet URLs.
- Preserves source playlist URLs with
listquery parameters on fresh tracker creation.
-
User-Driven Focus & Pacing:
- Pure-math dynamic pacing redistribution without guilt or rigid hour countdowns.
- Replaced rigid automated queue generation with self-paced topic pulling ("Focus Next" or pull directly into Today's Focus).
- Completed topics remain permanently visible in Today's Focus with strike-through styling and instant 1-tap Undo protection.
- Modern rectangular frosted glass day tiles with top-right floating circular effort badges and heat-mapped indicators matching theme accent colors.
📝 Commit History
abf70f6fix(ai): eliminate onboarding double-download race and stabilize restart loop27498f4fix(flags): decouple flag notes from checkpoints and fix status toast088ae99fix(sync): optimize single-video chapter sync to group by videoId and remap effort pointsc85e1c6fix(ingestion): calculate exact chapter effort points for single video resources27f67adfix(ui): greeting header, flag note edit dialog, tracker effort points, and 7-day metric effort unitsf207b96docs: add comprehensive end-to-end QA release testing guide39bef89feat(ui): smooth navigation cross-fade, global bouncing scroll physics, and dialog animationsea92d78fix(flow): connect ConfusingBeatDialog to persistent notes storage and prefill initial notede4c273feat(motion): integrate flutter_animate with central test-safe config, dock rebound, and staggered entrancesfc4b298feat(explore): introduce Flag Notes notebook section with search, filters, and checkpoint managementb75c4d2fix(backup): add native Android storage permission bridge, universal resilient backup fallback, and padding to effort badge177bdacfeat: float effort badge on top-right of square day tile & add manual backup creationb43bd3cfeat(flow): redesign weekly calendar day tile with top-right effort circle and synced heat colors54da8cbfix(icon): perfectly center icon ring with equal padding and remove double insetb72e1b9fix(explore): remove big attach button and fix delete tracker dialog text color8c270d8fix(ui, backup, icon): expand weekly calendar cells, link database, save backups to Documents, add Android adaptive icon45fc50estyle(flow): match mark flag icon color and icon with checkbox6283df8fix(ui): modern rectangle boxes for weekly calendar and liquid glass styling for attach dialog5456311fix(metrics): replace beat counts with actual effort point values across calendars and performance graphs4ed9b73feat: complete UI transition to effort presentation and multi-playlist automatic sync72c274cfeat(ingestion): persist playlist url and list param on fresh tracker creationf1b9f7afix(sync): ensure accurate duration extraction, remap standalone beats, and prompt for sync url759fd58fix(lint): clean up unused imports and add const constructors in tests55dcb10fix(sync-vault): fix sync timeout with fast playlist remapping, redesign backup into unified Data Vault, and stabilize snapshot storage3643b4bfix(sync-backup): resolve sync freeze, add effort UI badge, auto-normalize backup effort, and fix snapshot discovery564ea8bfeat(effort): implement 10-min effort calculation, resource sync engine, and icon-only buttonsd8d86c3feat(flow): add percentage checkpoints with proportional effort points and action menuf11b8d4fix: prevent download banner overflow and apply bold tracker-matched current focus header60d42bafeat: icon-only current focus with return button, and resilient background model downloading86bd7c5feat: append active topic at bottom, move return to tracker below, and balance marginsc091d0efeat: show full description on focus card click and enhance tracker title with icon538c8c5feat: implement Today's Focus pull-ahead with multi-state progress cycle, undo toast, and bold styling2ea8680feat: strip todo suggestion system, backlog debt, and revision services8f188fafeat: strip target beat and study quota system from onboarding and settings9a356eafix: support background and app closure download resumption for offline AI models22cb200fix: resolve model download failure from asset not found by re-uploading weights to release3bba2a2fix(ci): automate on-device AI model mirroring to release tagaa3c34ffeat(ai): bundle offline on-device AI models in release assets and add download manager3589b25fix(pacing): recalculate daily pacing dynamically using real target datesb0e1e69feat(explore): show exact item counts on tracker cards and add search filter5ec49b3feat(explore): add dynamic topic search with auto-highlight and accordion expansion09c13d7feat(explore): add collapsible chapters, search filtering, and clean roadmap cardse94e5e7feat(flow): add manual syllabus alignment confirmation prompt for ambiguous topic matches010d8a5feat(explore): tap to play beats in YouTube and open attached learning materialse5d0d8ffeat(flow): show active tracker name with color dot and streamline explore cards6a4760bfix: mobile YouTube extraction resilience and URL sanitization2d53473fix: playlist extraction multi-renderer support and zero-drop chapter division3369b65feat: add storage syllabus import, custom categories, system theme default, and unbounded playlist extractioncc6740ffix(ci): update release step to overwrite existing APK asset via gh release upload --clobber160fa87fix(ci): update release step to use GitHub CLI and configure Node compatibility830632bfeat: enhance tracker UI, syllabus import, mentor sequence priority, and unbounded topicsd6cc176feat(explore): implement explore screen, new track modal, and roadmap detail accordionsb4bd85dfeat(ui): round navigation dock and render full todo checklist across tracksd2503e0feat(flow): implement flow screen, session detail focus mode, and persistent bottom dock05ef3fffeat(ui): display daily pacing budget pill in hero card and add active status badge880f666feat(ui): add interactive on-device pacing simulation and today's queue showcase2ba0d36feat(pacing): implement pure-math pacing engine, queue walker, and backlog dilution02e9a04fix(ingestion): support modern YouTube playlist extraction and enhance tracker UI02c1940feat(ui): add interactive 3-condition ingestion test harness and custom YouTube importere4316defeat(ingestion): implement curriculum ingestion engine, chapter clustering, and syllabus matcherd8353f9feat(ui): wire interactive showcase to live SQLite database and bundle offline fontsa148d62feat(database): implement on-device SQLite engine, data contracts, and reactive repositories3510499feat(assets): integrate official liquid glass pulse logo and Android launcher iconsb2035aafeat(theme): add Apple Control Center style light frosted glass theme and theme toggle9bdc440feat(typography): adopt Poppins font family across liquid glass theme9dbdd6bfeat(ui): implement monochrome liquid glass design system and interactive showcase7c2dfabfeat: initialize Flutter project structure, native Android configuration, and CI pipeline461fabadocs: add system architecture, design specifications, and user flowsad60469chore: configure agent rules860ebdfchore: initial commit with README and PolyForm Noncommercial License