How mirkp/jarful works
Jarful is a personal time-tracking app: a user starts or switches an activity timer, optionally tags it with a sub-category, and reviews time in daily history and weekly summaries. Separate workflows track sleep and create period-based goals visualized as filling vessels. The tracker context coordinates optimistic updates and loads data through a store interface, backed by either browser demo data or Supabase. The README and source index support the main routes and integrations; several UI-to-provider and storage details are documented rather than fully excerpted.
Main entry points: tracker-context.tsx Tracker context · (app)/page.tsx Today tracking · goals/page.tsx Goal management · sleep/page.tsx Sleep tracking
Components 27
Access and navigation
Time and sleep tracking
- Today tracking
src/app/(app)/page.tsx - Activity editor
src/components/ActivityForm.tsx - Manual entries
src/components/TimeEntryForm.tsx - Entry history
src/components/EntryHistory.tsx - Active timer
src/components/ActiveTimer.tsx - Sleep tracking
src/app/(app)/sleep/page.tsx - Sleep editor
src/components/SleepForm.tsx - Sleep summaries
src/lib/sleep.ts
Goals and insights
- Weekly summary
src/app/(app)/week/page.tsx - Weekly chart
src/components/WeeklyChart.tsx - Time statistics
src/lib/stats.ts - Goal management
src/app/(app)/goals/page.tsx - Goal editor
src/components/GoalForm.tsx - Vessel display
src/components/Bottle.tsx - Goal calculations
src/lib/goals.ts
Application state
- Auth context
src/lib/auth-context.tsx - Tracker context
src/lib/tracker-context.tsx - Domain records
src/types/database.ts
Data storage
- Store interface
src/lib/data/store.ts - Demo store
src/lib/data/demo-store.ts - Supabase store
src/lib/data/supabase-store.ts - Supabase client
src/lib/supabase/client.ts
Other components
- User
- Supabase service
Connections 38
- User → Login: signs in
- Login → Auth context: authenticates
src/app/login/page.tsx - User → Today tracking: tracks time
README.md - Today tracking → Active timer: shows timer
src/app/(app)/page.tsx - Today tracking → Activity editor: edits activities
src/app/(app)/page.tsx - Today tracking → Manual entries: adds entries
src/app/(app)/page.tsx - Today tracking → Entry history: shows history
src/app/(app)/page.tsx - Today tracking → Tracker context: reads and updates
src/app/(app)/page.tsx - Activity editor → Tracker context: saves activity
src/components/ActivityForm.tsx - Manual entries → Tracker context: saves entry
src/components/TimeEntryForm.tsx - Active timer → User: shows elapsed time
README.md - User → Sleep tracking: logs sleep
README.md - Sleep tracking → Sleep editor: opens editor
src/app/(app)/sleep/page.tsx - Sleep tracking → Sleep summaries: summarizes nights
src/app/(app)/sleep/page.tsx - Sleep tracking → Tracker context: reads and updates
src/app/(app)/sleep/page.tsx - User → Weekly summary: reviews week
README.md - Weekly summary → Weekly chart: renders chart
src/app/(app)/week/page.tsx - Weekly summary → Time statistics: computes totals
src/app/(app)/week/page.tsx - Weekly summary → Tracker context: reads entries
src/app/(app)/week/page.tsx - User → Goal management: sets goals
README.md - Goal management → Goal editor: edits goals
src/app/(app)/goals/page.tsx - Goal management → Vessel display: renders progress
src/app/(app)/goals/page.tsx - Goal management → Goal calculations: calculates progress
src/app/(app)/goals/page.tsx - Goal management → Tracker context: reads goals
src/app/(app)/goals/page.tsx - Goal editor → Tracker context: saves goals
src/components/GoalForm.tsx - Goal calculations → Time statistics: uses time totals
src/lib/goals.ts - User → Settings: manages settings
README.md - Settings → Tracker context: manages activities
src/app/(app)/settings/page.tsx - App shell → Auth context: checks session
src/app/(app)/layout.tsx - App shell → Tracker context: provides tracker
src/app/(app)/layout.tsx - Auth context → Supabase client: uses client
src/lib/auth-context.tsx - Tracker context → Store interface: persists changes
src/lib/tracker-context.tsx - Store interface → Demo store: implemented by
README.md - Store interface → Supabase store: implemented by
README.md - Supabase store → Supabase client: queries through
src/lib/data/supabase-store.ts - Supabase client → Supabase service: connects to
README.md - Demo store → User: stores in browser
README.md - Tracker context → Domain records: manages records
src/lib/tracker-context.tsx