How evan5467/groove works
Tempo is an offline-first Android study-routine app. A learner unlocks the encrypted library, adds typed notes or files, and Tempo extracts and structures the material into topics; the planner turns topics into dated study and revision sessions that appear in Today and weekly views. State and the vault persist encrypted records locally, while on-device reminders and encrypted backup/restore support ongoing use. The main flow is supported by the excerpts and README; some secondary UI wiring and restore details are unsampled, so those links are omitted.
Main entry points: views.js Views and workflows · ingest.js Ingest pipeline · state.js App state · main.js App entry
Components 22
App and interface
- App entry
src/main.js - Views and workflows
src/views.js - Safe DOM and sheets
src/dom.js - App state
src/state.js
Study content
- File validation
src/core/files.js - Outline parser
src/core/parse.js - AI structuring
src/core/ai.js - Starter library
src/core/starter.js - Data validation
src/core/schema.js
Planning and reminders
- Study planner
src/core/plan.js - Reminder schedule
src/core/remind.js - Phone notifications
src/io/notify.js
Local data and privacy
- Encrypted vault
src/core/vault.js - Encryption
src/core/crypto.js - IndexedDB storage
src/core/storage.js - Encrypted backup
src/backup.js
Material ingestion
- Ingest pipeline
src/io/ingest.js - On-device OCR
src/io/ocr.js - PDF extraction
src/io/pdf.js - Image preparation
src/io/image.js
Other components
- Learner
- AI provider
Connections 27
- Learner → App entry: opens app
README.md - App entry → App state: boots and renders
src/main.js - App entry → Views and workflows: renders
src/main.js - Views and workflows → Safe DOM and sheets: builds interface
src/views.js - Learner → Views and workflows: uses study workflows
README.md - Views and workflows → App state: updates study state
src/views.js - Views and workflows → Ingest pipeline: submits material
src/views.js - Ingest pipeline → File validation: validates files
src/io/ingest.js - Ingest pipeline → Image preparation: prepares images
src/io/ingest.js - Ingest pipeline → On-device OCR: recognizes text
src/io/ingest.js - Ingest pipeline → PDF extraction: extracts PDF text
src/io/ingest.js - Ingest pipeline → Outline parser: structures text
src/io/ingest.js - Ingest pipeline → AI structuring: requests structuring
src/io/ingest.js - AI structuring → AI provider: sends extracted text
README.md - App state → Data validation: sanitizes records
src/state.js - App state → Starter library: loads starter content
src/state.js - App state → Study planner: generates plans
src/state.js - Views and workflows → Study planner: builds plan
src/views.js - App state → Encrypted vault: loads and saves
src/state.js - Encrypted vault → Encryption: encrypts records
src/core/vault.js - Encrypted vault → IndexedDB storage: persists ciphertext
- App entry → Phone notifications: syncs reminders
src/main.js - App state → Phone notifications: clears reminders
src/state.js - Phone notifications → Reminder schedule: computes schedule
src/io/notify.js - Views and workflows → Reminder schedule: shows overdue work
src/views.js - Views and workflows → Encrypted backup: shares backup
src/views.js - App entry → Encrypted backup: cleans cached backups
src/main.js