How peternunley08-ops/brain-navigator works
Brain Navigator is a local-first iPhone companion for a high-school student, organizing schoolwork and everyday wellbeing in a calm, Ember-led interface. The main user journey begins at the Desk, then branches into school planning, focused study, quick capture, and Steady’s wellbeing tools; the Drawer exposes additional helpers and personal features. Local JSON-backed state is a key internal layer, and optional AI is a separate capability. The map follows README-documented capabilities and indexed source references; unsampled implementation details and uncertain connections are left out.
Main entry points: schoolStore.ts School data · index.tsx Desk · drawer.tsx Navigation · school.tsx School screens
Components 20
App experience
- Desk
app/index.tsx - Navigation
app/drawer.tsx - Quick add
app/add-assignment.tsx - Candlelight theme
core/theme.ts - Screen framework
components/ui/Screen.tsx - Button controls
components/ui/Button.tsx
School planning
- School screens
app/school.tsx - Focus session
app/focus.tsx - Calendar integration
core/googleCalendarStore.ts - Notion integration
core/notion.ts
Wellbeing
- Steady tools
app/steady.tsx - Notes and journal
app/notes.tsx
Ember and helpers
- Ember companion
components/ember/EmberBuddy.tsx - Study helpers
app/helpers.tsx - Helper activities
app/helper/[id].tsx - Ember AI service
supabase/functions/ember/index.ts
Local state
- School data
core/schoolStore.ts - Life data
core/lifeStore.ts - Wellness data
core/wellnessStore.ts
Other components
- Student
Connections 17
- Student → Desk: opens
- Student → School screens: uses
- Student → Focus session: starts
- Student → Steady tools: uses
- Student → Quick add: adds through
- Student → Navigation: browses
- School screens → School data: manages
- Focus session → School data: records sessions
- Steady tools → Wellness data: tracks
- Notes and journal → Life data: stores entries
- Desk → Ember companion: features
app/index.tsx - Navigation → Study helpers: opens
- Study helpers → Helper activities: opens
app/helper/[id].tsx - Ember companion → Ember AI service: may use
- School data → Notion integration: integrates optionally
- Screen framework → Candlelight theme: uses
components/ui/Screen.tsx - Button controls → Candlelight theme: uses
components/ui/Button.tsx