How robi46/focus-forge works
FocusForge is a local-first Android study timer. The main workflow is to configure a rhythm and optional goal, run focus and rest rounds with audible/notification cues, then review recorded sessions through analytics and growth progress. Separate workspaces support notes and routines, Android focus guidance, and optional advertising. The README documents module responsibilities and capabilities, but source excerpts were not provided, so the graph omits uncertain implementation-level wiring.
Components 23
Focus sessions
- Focus dashboard
- Rhythm designer
- Session provider
- Timer state machine
- Cue transitions
Progress and planning
- History and goals
- Focus analytics
- Notes workspace
- Notes and routines
- Growth progression
- Garden, Hive, River
Device integrations
- Cue scheduling
- Notification behavior
- Repeated audio cues
- On-device storage
- Focus Shield guidance
- Allowed interruptions
- Audio and preferences
Optional monetization
- Consent-aware ads
Other components
- Student
- Android notifications
- Device audio
- Ad service
Connections 26
- Student → Focus dashboard: starts sessions
- Student → Rhythm designer: designs rhythm
- Student → History and goals: reviews progress
- Student → Notes workspace: plans study
- Student → Focus Shield guidance: checks setup
- Student → Audio and preferences: sets preferences
- Focus dashboard → Session provider: controls session
- Rhythm designer → Session provider: sets rhythm
- Session provider → Timer state machine: advances rounds
- Session provider → On-device storage: persists state
- Session provider → Cue transitions: emits transitions
- Session provider → Cue scheduling: schedules cues
- Cue scheduling → Notification behavior: uses behavior
- Notification behavior → Android notifications: schedules alerts
- Cue transitions → Repeated audio cues: triggers replay
- Repeated audio cues → Device audio: plays cues
- History and goals → Focus analytics: derives insights
- Focus analytics → On-device storage: reads sessions
- Notes workspace → Notes and routines: manages content
- Notes and routines → On-device storage: persists notes
- Session provider → Growth progression: updates progress
- Growth progression → On-device storage: persists growth
- Growth progression → Garden, Hive, River: supplies progression
- Student → Allowed interruptions: selects exceptions
- Student → Consent-aware ads: opts into rewards
- Consent-aware ads → Ad service: requests ads