How lanzz-18/gotham-protocol works
This is a Batman-themed habit and personal progression app: users record actions against five pillars, earn XP and ranks, review history and weekly progress, and can sync their profile and logs across devices. The principal flow runs from the React app through its store into progression calculations and local persistence, with optional cloud synchronization. The README is a generic Vite template and documents no product features; UI and engine connections below use the supplied source index, so unsampled implementation details are not assumed.
Main entry points: App.tsx App shell · useStore.ts App state · week.ts Week summaries · ProfilePanel.tsx Profile
Components 28
App experience
- App shell
src/ui/App.tsx - Pillar logging
src/ui/PillarsView.tsx - Profile
src/ui/ProfilePanel.tsx - History
src/ui/HistoryView.tsx - Stats
src/ui/StatsView.tsx - Rogues gallery
src/ui/RoguesGallery.tsx - Settings
src/ui/SettingsView.tsx - Authentication
src/ui/AuthModal.tsx - Rest week
src/ui/RestWeek.tsx
State and sync
- App state
src/store/useStore.ts - Local database
src/store/db.ts - Sync outbox
src/store/outbox.ts - Cloud sync
src/store/cloudSync.ts
Progression engine
- Progress config
src/engine/config.ts - XP and levels
src/engine/xp.ts - Ranks
src/engine/ranks.ts - Streaks
src/engine/streak.ts - Week summaries
src/engine/week.ts - Nemesis system
src/engine/nemesis.ts - Activity series
src/engine/series.ts - History merge
src/engine/sync.ts - Time source
src/engine/clock.ts
Presentation support
- Sound effects
src/lib/audio.ts - Formatting and export
src/lib/format.ts - Icon rendering
src/ui/Icons.tsx - Icon data
src/ui/icon-data.ts
Other components
- User
- Supabase service
Connections 42
- User → App shell: uses
- App shell → App state: reads and updates
src/ui/App.tsx - App shell → Pillar logging: renders
src/ui/App.tsx - App shell → Profile: renders
src/ui/App.tsx - App shell → History: renders
src/ui/App.tsx - App shell → Stats: renders
src/ui/App.tsx - App shell → Rogues gallery: renders
src/ui/App.tsx - App shell → Settings: renders
src/ui/App.tsx - App shell → Authentication: renders
src/ui/App.tsx - App shell → Rest week: renders
src/ui/App.tsx - App shell → Formatting and export: exports backup
src/ui/App.tsx - App shell → Sound effects: plays sounds
src/ui/App.tsx - Profile → App state: reads state
src/ui/ProfilePanel.tsx - Profile → XP and levels: calculates progress
src/ui/ProfilePanel.tsx - Profile → Ranks: calculates rank
src/ui/ProfilePanel.tsx - Stats → App state: reads state
src/ui/StatsView.tsx - Stats → Week summaries: summarizes weeks
src/ui/StatsView.tsx - Stats → Activity series: uses activity series
src/ui/StatsView.tsx - Rogues gallery → App state: reads state
src/ui/RoguesGallery.tsx - Rogues gallery → Nemesis system: computes villains
src/ui/RoguesGallery.tsx - Settings → App state: updates settings
src/ui/SettingsView.tsx - Settings → Supabase service: uses client
src/ui/SettingsView.tsx - App state → Local database: loads and saves
src/store/useStore.ts - App state → Cloud sync: authenticates and syncs
src/store/useStore.ts - App state → Sync outbox: queues changes
src/store/useStore.ts - App state → Ranks: computes pillars
src/store/useStore.ts - App state → Week summaries: checks rest weeks
src/store/useStore.ts - App state → Progress config: uses defaults
src/store/useStore.ts - Cloud sync → History merge: merges history
src/store/cloudSync.ts - Cloud sync → Supabase service: uses client
src/store/cloudSync.ts - Sync outbox → Local database: persists operations
src/store/outbox.ts - Sync outbox → Cloud sync: flushes changes
src/store/outbox.ts - Ranks → XP and levels: derives levels
src/engine/ranks.ts - Streaks → Time source: reads time
src/engine/streak.ts - Week summaries → Streaks: uses day rules
src/engine/week.ts - Week summaries → Time source: reads time
src/engine/week.ts - Nemesis system → Streaks: uses day rules
src/engine/nemesis.ts - Nemesis system → Week summaries: converts day index
src/engine/nemesis.ts - Nemesis system → XP and levels: calculates villain XP
src/engine/nemesis.ts - Activity series → Streaks: uses day rules
src/engine/series.ts - Activity series → Time source: reads time
src/engine/series.ts - Icon rendering → Icon data: reads definitions
src/ui/Icons.tsx