How jushazen/compleit-app works
Compleit is a local-first habit tracker: users review today’s scheduled habits, record completions, create or edit habits, and inspect completion history in a heatmap; they can also change the app theme. The app shell routes between screens and opens the form and theme menu. Context providers hydrate and serialize mutations before persisting habits, completions, and settings. Schedule, date, time, streak, and heatmap logic support the user-facing stages. The README describes only the React Native starter setup, so product capabilities are inferred from the source index and excerpts; unsampled implementation details are not expanded.
Main entry points: Home.tsx Today screen · HabitContext.tsx Habit state · AppShell.tsx App shell · schedule.ts Schedule rules
Components 23
App experience
- App shell
src/app/AppShell.tsx - Today screen
src/screens/Home.tsx - Heatmap screen
src/screens/Heatmap.tsx
Habit management
- Habit form
src/screens/HabitForm.tsx - Form validation
src/logic/validation.ts
Habit logic
- Habit transitions
src/logic/habitState.ts - Serial queue
src/logic/serialQueue.ts - Schedule rules
src/logic/schedule.ts - Date utilities
src/logic/dateUtils.ts - Time utilities
src/logic/time.ts - Today grouping
src/logic/buckets.ts - Streak calculation
src/logic/streak.ts - Heatmap calculation
src/logic/heatmap.ts
State and persistence
- Habit state
src/context/HabitContext.tsx - Settings state
src/context/SettingsContext.tsx - Provider tree
src/context/ProviderTree.tsx - Local storage
src/storage/storage.ts - Habit data types
src/storage/types.ts
Appearance
- Theme menu
src/app/ThemeMenu.tsx - Theme hooks
src/hooks/useTheme.ts - Theme tokens
src/theme/tokens.ts
Other components
- App user
- AsyncStorage
Connections 38
- App user → App shell: uses
src/app/AppShell.tsx - App shell → Today screen: routes
src/app/AppShell.tsx - App shell → Heatmap screen: routes
src/app/AppShell.tsx - App shell → Habit form: opens
src/app/AppShell.tsx - App shell → Theme menu: opens
src/app/AppShell.tsx - Today screen → Habit state: reads and mutates
src/screens/Home.tsx - Today screen → Today grouping: groups habits
src/screens/Home.tsx - Today screen → Date utilities: dates completion
src/screens/Home.tsx - Today screen → Time utilities: formats times
src/screens/Home.tsx - Today screen → Schedule rules: uses schedule rules
src/screens/Home.tsx - Today screen → Streak calculation: shows streaks
src/screens/Home.tsx - Heatmap screen → Habit state: reads history
src/screens/Heatmap.tsx - Heatmap screen → Heatmap calculation: builds heatmap
src/screens/Heatmap.tsx - Habit form → Habit state: saves habit
src/screens/HabitForm.tsx - Habit form → Form validation: validates input
src/screens/HabitForm.tsx - Habit form → Time utilities: handles times
src/screens/HabitForm.tsx - Provider tree → Habit state: provides
src/context/ProviderTree.tsx - Provider tree → Settings state: provides
src/context/ProviderTree.tsx - Habit state → Serial queue: serializes mutations
src/context/HabitContext.tsx - Habit state → Habit transitions: applies transitions
src/context/HabitContext.tsx - Habit state → Local storage: loads and saves
src/context/HabitContext.tsx - Settings state → Serial queue: serializes writes
src/context/SettingsContext.tsx - Settings state → Local storage: loads and saves
src/context/SettingsContext.tsx - Local storage → AsyncStorage: reads and writes
src/storage/storage.ts - Local storage → Habit data types: uses data types
src/storage/storage.ts - Habit transitions → Habit data types: transforms data
src/context/HabitContext.tsx - Schedule rules → Date utilities: uses calendar dates
src/logic/schedule.ts - Schedule rules → Time utilities: sorts by time
src/logic/schedule.ts - Today grouping → Schedule rules: groups by schedule
src/logic/buckets.ts - Today grouping → Date utilities: uses dates
src/logic/buckets.ts - Streak calculation → Schedule rules: checks due days
src/logic/streak.ts - Streak calculation → Date utilities: uses dates
src/logic/streak.ts - Heatmap calculation → Schedule rules: checks schedule
src/logic/heatmap.ts - Heatmap calculation → Date utilities: calculates dates
src/logic/heatmap.ts - Theme menu → Settings state: changes theme
src/app/ThemeMenu.tsx - App shell → Settings state: reads theme
src/app/AppShell.tsx - Theme hooks → Settings state: reads theme
src/hooks/useTheme.ts - Theme hooks → Theme tokens: gets palette
src/hooks/useTheme.ts