How rianpramudya/habittracker works
HabitTracker is a responsive personal habit-tracking product, with finance, reflection, preferences, and gated social features. Its principal workflow is recording habits or other entries, applying domain rules, and viewing progress; finance adds wallets, transactions, balances, and history. The README describes the current experience primarily as a synthetic-data preview: product authentication and cloud writes remain gated, and social, payments, Telegram, and admin are incomplete or fail closed. Edges reflect excerpts, indexed imports, or README statements; unsampled UI-to-API wiring is intentionally not assumed.
Main entry points: server.ts Supabase clients · account/route.ts Account endpoint · social/route.ts Feed endpoint · dashboard.tsx Habit dashboard
Components 30
User experience
- Habit dashboard
src/components/dashboard.tsx - Product navigation
src/components/product-navigation.tsx - Finance workspace
src/components/financial/financial-client.tsx - Feed client
src/components/social/feed-client.tsx - People client
src/components/social/people-client.tsx - Profile client
src/components/social/profile-client.tsx - Moderation client
src/components/social/moderation-client.tsx
Personal tracking
- Tracking rules
src/modules/tracking/domain.ts - Preview state
src/lib/preview.ts - Finance contracts
src/modules/finance/contracts.ts - Command endpoint
src/app/api/commands/route.ts - Finance endpoint
src/app/api/financial/route.ts - Preferences endpoint
src/app/api/preferences/route.ts
Identity and access
- Account endpoint
src/app/api/account/route.ts - Auth contracts
src/modules/auth/contracts.ts - Development gates
src/modules/auth/dev-mode.ts - Session identity
src/modules/auth/session-id.ts - Supabase clients
src/lib/supabase/server.ts
Social features
- Feed endpoint
src/app/api/social/route.ts - Social identity
src/modules/social/access.ts - Social feature gate
src/modules/social/flags.ts - Social contracts
src/modules/social/contracts.ts - Profile contracts
src/modules/social/profile-contracts.ts - Avatar editor
src/components/social/avatar-editor.tsx - Avatar endpoints
src/app/api/social/avatar/route.ts - Profile endpoints
src/app/api/social/profile/route.ts - People endpoint
src/app/api/social/people/route.ts - Moderation endpoint
src/app/api/social/moderation/route.ts
Other components
- User
- Supabase service
Connections 35
- User → Habit dashboard: uses preview
README.md - Habit dashboard → Tracking rules: uses rules
src/components/dashboard.tsx - Habit dashboard → Preview state: loads preview
src/components/dashboard.tsx - Habit dashboard → Product navigation: renders
src/components/dashboard.tsx - Finance workspace → Tracking rules: uses calculations
src/components/financial/financial-client.tsx - Finance workspace → Finance contracts: uses contracts
src/components/financial/financial-client.tsx - Finance workspace → Product navigation: renders
src/components/financial/financial-client.tsx - Feed client → Social contracts: uses types
src/components/social/feed-client.tsx - Feed client → Product navigation: uses navigation
src/components/social/feed-client.tsx - People client → Profile contracts: uses types
src/components/social/people-client.tsx - Profile client → Profile contracts: uses types
src/components/social/profile-client.tsx - Profile client → Avatar editor: uses editor
src/components/social/profile-client.tsx - People client → Feed client
- Command endpoint → Tracking rules: applies commands
src/app/api/commands/route.ts - Command endpoint → Supabase clients: reads and commits
src/app/api/commands/route.ts - Finance endpoint → Supabase clients: accesses data
src/app/api/financial/route.ts - Account endpoint → Auth contracts: validates input
src/app/api/account/route.ts - Account endpoint → Development gates: checks gates
src/app/api/account/route.ts - Account endpoint → Session identity: extracts session
src/app/api/account/route.ts - Account endpoint → Supabase clients: authenticates
src/app/api/account/route.ts - Feed endpoint → Social contracts: validates actions
src/app/api/social/route.ts - Feed endpoint → Social feature gate: checks gate
src/app/api/social/route.ts - Feed endpoint → Session identity: extracts session
src/app/api/social/route.ts - Feed endpoint → Supabase clients: reads and commits
src/app/api/social/route.ts - Social identity → Supabase clients: checks identity
src/modules/social/access.ts - Social identity → Development gates: checks email
src/modules/social/access.ts - Social identity → Session identity: extracts session
src/modules/social/access.ts - Social feature gate → Development gates: checks availability
src/modules/social/flags.ts - Avatar endpoints → Supabase clients: accesses data
src/app/api/social/avatar/route.ts - Profile endpoints → Profile contracts: validates profile
src/app/api/social/profile/route.ts - Profile endpoints → Supabase clients: accesses data
src/app/api/social/profile/route.ts - People endpoint → Profile contracts: validates query
src/app/api/social/people/route.ts - People endpoint → Supabase clients: accesses data
src/app/api/social/people/route.ts - Moderation endpoint → Supabase clients: accesses data
src/app/api/social/moderation/route.ts - Supabase clients → Supabase service: connects to
src/lib/supabase/server.ts