# rianpramudya/habittracker architecture

> Architecture diagram of the GitHub repository rianpramudya/habittracker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rianpramudya/habittracker
- Repository: https://github.com/rianpramudya/habittracker

## Overview

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: [`src/lib/supabase/server.ts`](https://github.com/rianpramudya/habittracker/blob/main/src/lib/supabase/server.ts) (Supabase clients), [`src/app/api/account/route.ts`](https://github.com/rianpramudya/habittracker/blob/main/src/app/api/account/route.ts) (Account endpoint), [`src/app/api/social/route.ts`](https://github.com/rianpramudya/habittracker/blob/main/src/app/api/social/route.ts) (Feed endpoint), [`src/components/dashboard.tsx`](https://github.com/rianpramudya/habittracker/blob/main/src/components/dashboard.tsx) (Habit dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_dashboard["Habit dashboard<br/>[dashboard.tsx]"]
  node_navigation["Product navigation"]
  node_finance_ui["Finance workspace"]
  node_social_feed_ui["Feed client<br/>[feed-client.tsx]"]
  node_people_ui["People client<br/>[people-client.tsx]"]
  node_profile_ui["Profile client<br/>[profile-client.tsx]"]
  node_moderation_ui["Moderation client"]
end

subgraph group_tracking["Personal tracking"]
  node_tracking_domain["Tracking rules<br/>[domain.ts]"]
  node_preview_state["Preview state<br/>[preview.ts]"]
  node_finance_contracts["Finance contracts<br/>[contracts.ts]"]
  node_commands_api["Command endpoint<br/>[route.ts]"]
  node_financial_api["Finance endpoint<br/>[route.ts]"]
  node_preferences_api["Preferences endpoint<br/>[route.ts]"]
end

subgraph group_identity["Identity and access"]
  node_auth_api["Account endpoint<br/>[route.ts]"]
  node_auth_contracts["Auth contracts<br/>[contracts.ts]"]
  node_dev_access["Development gates<br/>[dev-mode.ts]"]
  node_session_id["Session identity<br/>[session-id.ts]"]
  node_supabase["Supabase clients<br/>[server.ts]"]
end

subgraph group_community["Social features"]
  node_social_api["Feed endpoint<br/>[route.ts]"]
  node_social_access["Social identity<br/>[access.ts]"]
  node_social_flags["Social feature gate<br/>[flags.ts]"]
  node_social_contracts["Social contracts<br/>[contracts.ts]"]
  node_profile_contracts["Profile contracts"]
  node_avatar_editor["Avatar editor<br/>[avatar-editor.tsx]"]
  node_avatar_api["Avatar endpoints<br/>[route.ts]"]
  node_profile_api["Profile endpoints<br/>[route.ts]"]
  node_people_api["People endpoint<br/>[route.ts]"]
  node_moderation_api["Moderation endpoint<br/>[route.ts]"]
end

node_user(("User"))
node_external_db[("Supabase service")]

node_user -->|"uses preview"| node_dashboard
node_dashboard -->|"uses rules"| node_tracking_domain
node_dashboard -->|"loads preview"| node_preview_state
node_dashboard -->|"renders"| node_navigation
node_finance_ui -->|"uses calculations"| node_tracking_domain
node_finance_ui -->|"uses contracts"| node_finance_contracts
node_finance_ui -->|"renders"| node_navigation
node_social_feed_ui -->|"uses types"| node_social_contracts
node_social_feed_ui -->|"uses navigation"| node_navigation
node_people_ui -->|"uses types"| node_profile_contracts
node_profile_ui -->|"uses types"| node_profile_contracts
node_profile_ui -->|"uses editor"| node_avatar_editor
node_people_ui -.-> node_social_feed_ui
node_commands_api -->|"applies commands"| node_tracking_domain
node_commands_api -->|"reads and commits"| node_supabase
node_financial_api -->|"accesses data"| node_supabase
node_auth_api -->|"validates input"| node_auth_contracts
node_auth_api -->|"checks gates"| node_dev_access
node_auth_api -->|"extracts session"| node_session_id
node_auth_api -->|"authenticates"| node_supabase
node_social_api -->|"validates actions"| node_social_contracts
node_social_api -->|"checks gate"| node_social_flags
node_social_api -->|"extracts session"| node_session_id
node_social_api -->|"reads and commits"| node_supabase
node_social_access -->|"checks identity"| node_supabase
node_social_access -->|"checks email"| node_dev_access
node_social_access -->|"extracts session"| node_session_id
node_social_flags -->|"checks availability"| node_dev_access
node_avatar_api -->|"accesses data"| node_supabase
node_profile_api -->|"validates profile"| node_profile_contracts
node_profile_api -->|"accesses data"| node_supabase
node_people_api -->|"validates query"| node_profile_contracts
node_people_api -->|"accesses data"| node_supabase
node_moderation_api -->|"accesses data"| node_supabase
node_supabase -->|"connects to"| node_external_db

click node_dashboard "https://github.com/rianpramudya/habittracker/blob/main/src/components/dashboard.tsx"
click node_navigation "https://github.com/rianpramudya/habittracker/blob/main/src/components/product-navigation.tsx"
click node_finance_ui "https://github.com/rianpramudya/habittracker/blob/main/src/components/financial/financial-client.tsx"
click node_social_feed_ui "https://github.com/rianpramudya/habittracker/blob/main/src/components/social/feed-client.tsx"
click node_people_ui "https://github.com/rianpramudya/habittracker/blob/main/src/components/social/people-client.tsx"
click node_profile_ui "https://github.com/rianpramudya/habittracker/blob/main/src/components/social/profile-client.tsx"
click node_moderation_ui "https://github.com/rianpramudya/habittracker/blob/main/src/components/social/moderation-client.tsx"
click node_tracking_domain "https://github.com/rianpramudya/habittracker/blob/main/src/modules/tracking/domain.ts"
click node_preview_state "https://github.com/rianpramudya/habittracker/blob/main/src/lib/preview.ts"
click node_finance_contracts "https://github.com/rianpramudya/habittracker/blob/main/src/modules/finance/contracts.ts"
click node_commands_api "https://github.com/rianpramudya/habittracker/blob/main/src/app/api/commands/route.ts"
click node_financial_api "https://github.com/rianpramudya/habittracker/blob/main/src/app/api/financial/route.ts"
click node_preferences_api "https://github.com/rianpramudya/habittracker/blob/main/src/app/api/preferences/route.ts"
click node_auth_api "https://github.com/rianpramudya/habittracker/blob/main/src/app/api/account/route.ts"
click node_auth_contracts "https://github.com/rianpramudya/habittracker/blob/main/src/modules/auth/contracts.ts"
click node_dev_access "https://github.com/rianpramudya/habittracker/blob/main/src/modules/auth/dev-mode.ts"
click node_session_id "https://github.com/rianpramudya/habittracker/blob/main/src/modules/auth/session-id.ts"
click node_supabase "https://github.com/rianpramudya/habittracker/blob/main/src/lib/supabase/server.ts"
click node_social_api "https://github.com/rianpramudya/habittracker/blob/main/src/app/api/social/route.ts"
click node_social_access "https://github.com/rianpramudya/habittracker/blob/main/src/modules/social/access.ts"
click node_social_flags "https://github.com/rianpramudya/habittracker/blob/main/src/modules/social/flags.ts"
click node_social_contracts "https://github.com/rianpramudya/habittracker/blob/main/src/modules/social/contracts.ts"
click node_profile_contracts "https://github.com/rianpramudya/habittracker/blob/main/src/modules/social/profile-contracts.ts"
click node_avatar_editor "https://github.com/rianpramudya/habittracker/blob/main/src/components/social/avatar-editor.tsx"
click node_avatar_api "https://github.com/rianpramudya/habittracker/blob/main/src/app/api/social/avatar/route.ts"
click node_profile_api "https://github.com/rianpramudya/habittracker/blob/main/src/app/api/social/profile/route.ts"
click node_people_api "https://github.com/rianpramudya/habittracker/blob/main/src/app/api/social/people/route.ts"
click node_moderation_api "https://github.com/rianpramudya/habittracker/blob/main/src/app/api/social/moderation/route.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dashboard,node_navigation,node_finance_ui,node_social_feed_ui,node_people_ui,node_profile_ui,node_moderation_ui,node_user toneBlue
class node_tracking_domain,node_preview_state,node_finance_contracts,node_commands_api,node_financial_api,node_preferences_api,node_external_db toneAmber
class node_auth_api,node_auth_contracts,node_dev_access,node_session_id,node_supabase toneMint
class node_social_api,node_social_access,node_social_flags,node_social_contracts,node_profile_contracts,node_avatar_editor,node_avatar_api,node_profile_api,node_people_api,node_moderation_api toneRose
```

## Components

### User experience

- [Habit dashboard](https://github.com/rianpramudya/habittracker/blob/main/src/components/dashboard.tsx): `src/components/dashboard.tsx`
- [Product navigation](https://github.com/rianpramudya/habittracker/blob/main/src/components/product-navigation.tsx): `src/components/product-navigation.tsx`
- [Finance workspace](https://github.com/rianpramudya/habittracker/blob/main/src/components/financial/financial-client.tsx): `src/components/financial/financial-client.tsx`
- [Feed client](https://github.com/rianpramudya/habittracker/blob/main/src/components/social/feed-client.tsx): `src/components/social/feed-client.tsx`
- [People client](https://github.com/rianpramudya/habittracker/blob/main/src/components/social/people-client.tsx): `src/components/social/people-client.tsx`
- [Profile client](https://github.com/rianpramudya/habittracker/blob/main/src/components/social/profile-client.tsx): `src/components/social/profile-client.tsx`
- [Moderation client](https://github.com/rianpramudya/habittracker/blob/main/src/components/social/moderation-client.tsx): `src/components/social/moderation-client.tsx`

### Personal tracking

- [Tracking rules](https://github.com/rianpramudya/habittracker/blob/main/src/modules/tracking/domain.ts): `src/modules/tracking/domain.ts`
- [Preview state](https://github.com/rianpramudya/habittracker/blob/main/src/lib/preview.ts): `src/lib/preview.ts`
- [Finance contracts](https://github.com/rianpramudya/habittracker/blob/main/src/modules/finance/contracts.ts): `src/modules/finance/contracts.ts`
- [Command endpoint](https://github.com/rianpramudya/habittracker/blob/main/src/app/api/commands/route.ts): `src/app/api/commands/route.ts`
- [Finance endpoint](https://github.com/rianpramudya/habittracker/blob/main/src/app/api/financial/route.ts): `src/app/api/financial/route.ts`
- [Preferences endpoint](https://github.com/rianpramudya/habittracker/blob/main/src/app/api/preferences/route.ts): `src/app/api/preferences/route.ts`

### Identity and access

- [Account endpoint](https://github.com/rianpramudya/habittracker/blob/main/src/app/api/account/route.ts): `src/app/api/account/route.ts`
- [Auth contracts](https://github.com/rianpramudya/habittracker/blob/main/src/modules/auth/contracts.ts): `src/modules/auth/contracts.ts`
- [Development gates](https://github.com/rianpramudya/habittracker/blob/main/src/modules/auth/dev-mode.ts): `src/modules/auth/dev-mode.ts`
- [Session identity](https://github.com/rianpramudya/habittracker/blob/main/src/modules/auth/session-id.ts): `src/modules/auth/session-id.ts`
- [Supabase clients](https://github.com/rianpramudya/habittracker/blob/main/src/lib/supabase/server.ts): `src/lib/supabase/server.ts`

### Social features

- [Feed endpoint](https://github.com/rianpramudya/habittracker/blob/main/src/app/api/social/route.ts): `src/app/api/social/route.ts`
- [Social identity](https://github.com/rianpramudya/habittracker/blob/main/src/modules/social/access.ts): `src/modules/social/access.ts`
- [Social feature gate](https://github.com/rianpramudya/habittracker/blob/main/src/modules/social/flags.ts): `src/modules/social/flags.ts`
- [Social contracts](https://github.com/rianpramudya/habittracker/blob/main/src/modules/social/contracts.ts): `src/modules/social/contracts.ts`
- [Profile contracts](https://github.com/rianpramudya/habittracker/blob/main/src/modules/social/profile-contracts.ts): `src/modules/social/profile-contracts.ts`
- [Avatar editor](https://github.com/rianpramudya/habittracker/blob/main/src/components/social/avatar-editor.tsx): `src/components/social/avatar-editor.tsx`
- [Avatar endpoints](https://github.com/rianpramudya/habittracker/blob/main/src/app/api/social/avatar/route.ts): `src/app/api/social/avatar/route.ts`
- [Profile endpoints](https://github.com/rianpramudya/habittracker/blob/main/src/app/api/social/profile/route.ts): `src/app/api/social/profile/route.ts`
- [People endpoint](https://github.com/rianpramudya/habittracker/blob/main/src/app/api/social/people/route.ts): `src/app/api/social/people/route.ts`
- [Moderation endpoint](https://github.com/rianpramudya/habittracker/blob/main/src/app/api/social/moderation/route.ts): `src/app/api/social/moderation/route.ts`

### Other components

- **User**
- **Supabase service**

## Connections

- User → Habit dashboard: uses preview (evidence: `README.md`)
- Habit dashboard → Tracking rules: uses rules (evidence: `src/components/dashboard.tsx`)
- Habit dashboard → Preview state: loads preview (evidence: `src/components/dashboard.tsx`)
- Habit dashboard → Product navigation: renders (evidence: `src/components/dashboard.tsx`)
- Finance workspace → Tracking rules: uses calculations (evidence: `src/components/financial/financial-client.tsx`)
- Finance workspace → Finance contracts: uses contracts (evidence: `src/components/financial/financial-client.tsx`)
- Finance workspace → Product navigation: renders (evidence: `src/components/financial/financial-client.tsx`)
- Feed client → Social contracts: uses types (evidence: `src/components/social/feed-client.tsx`)
- Feed client → Product navigation: uses navigation (evidence: `src/components/social/feed-client.tsx`)
- People client → Profile contracts: uses types (evidence: `src/components/social/people-client.tsx`)
- Profile client → Profile contracts: uses types (evidence: `src/components/social/profile-client.tsx`)
- Profile client → Avatar editor: uses editor (evidence: `src/components/social/profile-client.tsx`)
- People client → Feed client
- Command endpoint → Tracking rules: applies commands (evidence: `src/app/api/commands/route.ts`)
- Command endpoint → Supabase clients: reads and commits (evidence: `src/app/api/commands/route.ts`)
- Finance endpoint → Supabase clients: accesses data (evidence: `src/app/api/financial/route.ts`)
- Account endpoint → Auth contracts: validates input (evidence: `src/app/api/account/route.ts`)
- Account endpoint → Development gates: checks gates (evidence: `src/app/api/account/route.ts`)
- Account endpoint → Session identity: extracts session (evidence: `src/app/api/account/route.ts`)
- Account endpoint → Supabase clients: authenticates (evidence: `src/app/api/account/route.ts`)
- Feed endpoint → Social contracts: validates actions (evidence: `src/app/api/social/route.ts`)
- Feed endpoint → Social feature gate: checks gate (evidence: `src/app/api/social/route.ts`)
- Feed endpoint → Session identity: extracts session (evidence: `src/app/api/social/route.ts`)
- Feed endpoint → Supabase clients: reads and commits (evidence: `src/app/api/social/route.ts`)
- Social identity → Supabase clients: checks identity (evidence: `src/modules/social/access.ts`)
- Social identity → Development gates: checks email (evidence: `src/modules/social/access.ts`)
- Social identity → Session identity: extracts session (evidence: `src/modules/social/access.ts`)
- Social feature gate → Development gates: checks availability (evidence: `src/modules/social/flags.ts`)
- Avatar endpoints → Supabase clients: accesses data (evidence: `src/app/api/social/avatar/route.ts`)
- Profile endpoints → Profile contracts: validates profile (evidence: `src/app/api/social/profile/route.ts`)
- Profile endpoints → Supabase clients: accesses data (evidence: `src/app/api/social/profile/route.ts`)
- People endpoint → Profile contracts: validates query (evidence: `src/app/api/social/people/route.ts`)
- People endpoint → Supabase clients: accesses data (evidence: `src/app/api/social/people/route.ts`)
- Moderation endpoint → Supabase clients: accesses data (evidence: `src/app/api/social/moderation/route.ts`)
- Supabase clients → Supabase service: connects to (evidence: `src/lib/supabase/server.ts`)
