# rhon-dev/kasaran-app architecture

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

- Interactive diagram: https://gitdiagram.com/rhon-dev/kasaran-app
- Repository: https://github.com/rhon-dev/kasaran-app

## Overview

Kasaran is a wedding-budget planning app for Filipino couples. Its documented workflow covers budget setup, expense and hidden-fee tracking, pledges, guest scenarios, explainable allocations, and shared offline editing with sync. The tree contains Flutter screens and Supabase sync endpoints, although the README describes the repository as documentation-only; sampled endpoint code confirms push and pull are phase-04 stubs, not implemented data sync. Flutter wiring and domain implementations were not sampled, so those relationships are omitted or marked unverified.

Main entry points: [`lib/main.dart`](https://github.com/rhon-dev/kasaran-app/blob/main/lib/main.dart) (App entry), [`supabase/functions/sync_push/index.ts`](https://github.com/rhon-dev/kasaran-app/blob/main/supabase/functions/sync_push/index.ts) (Sync push), [`supabase/functions/_shared/auth.ts`](https://github.com/rhon-dev/kasaran-app/blob/main/supabase/functions/_shared/auth.ts) (Auth helper), [`lib/ui/screens/scr_03_setup_budget_date.dart`](https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_03_setup_budget_date.dart) (Budget setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Flutter client"]
  node_app["App entry<br/>[main.dart]"]
end

subgraph group_planning["Budget planning"]
  node_setup["Budget setup"]
  node_region["Region setup"]
  node_fees_setup["Fee setup"]
  node_dashboard["Dashboard"]
  node_ledger["Expense ledger"]
  node_expense_editor["Expense editor"]
  node_fee_editor["Fee editor"]
  node_allocations["Allocations"]
  node_figure["Figure explainer"]
  node_guests["Guest tracking"]
  node_guest_scenarios["Guest scenarios"]
  node_pledges["Pledge tracking"]
  node_pledge_editor["Pledge editor"]
end

subgraph group_collaboration["Shared plan"]
  node_change_log["Change log"]
  node_shared_access["Shared access"]
  node_plan_settings["Plan settings"]
  node_sync_detail["Sync detail"]
end

subgraph group_backend["Sync backend"]
  node_push["Sync push<br/>[index.ts]"]
  node_pull["Sync pull<br/>[index.ts]"]
  node_auth["Auth helper<br/>[auth.ts]"]
  node_validation["Push validation<br/>[validation.ts]"]
end

node_couple(("Couple"))
node_supabase[("Supabase Auth")]

node_couple -.->|"uses"| node_app
node_app -.->|"starts planning"| node_setup
node_setup -.->|"sets region"| node_region
node_region -.->|"prompts fees"| node_fees_setup
node_couple -.->|"reviews budget"| node_dashboard
node_couple -.->|"tracks expenses"| node_ledger
node_ledger -.->|"edits items"| node_expense_editor
node_couple -.->|"records fees"| node_fee_editor
node_couple -.->|"reviews allocation"| node_allocations
node_allocations -.->|"explains figures"| node_figure
node_couple -.->|"tracks guests"| node_guests
node_guests -.->|"previews changes"| node_guest_scenarios
node_couple -.->|"tracks pledges"| node_pledges
node_pledges -.->|"edits pledges"| node_pledge_editor
node_couple -.->|"shares plan"| node_shared_access
node_couple -.->|"reviews changes"| node_change_log
node_couple -.->|"configures plan"| node_plan_settings
node_couple -.->|"reviews sync"| node_sync_detail
node_push -->|"authenticates with"| node_auth
node_push -->|"validates body"| node_validation
node_pull -->|"authenticates with"| node_auth
node_auth -->|"verifies user"| node_supabase
node_app -.->|"sends changes"| node_push
node_app -.->|"requests changes"| node_pull

click node_app "https://github.com/rhon-dev/kasaran-app/blob/main/lib/main.dart"
click node_setup "https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_03_setup_budget_date.dart"
click node_region "https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_04_setup_guest_region.dart"
click node_fees_setup "https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_05_setup_hidden_fees.dart"
click node_dashboard "https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_06_dashboard.dart"
click node_ledger "https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_07_ledger_list.dart"
click node_expense_editor "https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_08_expense_editor.dart"
click node_fee_editor "https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_09_hidden_fee_editor.dart"
click node_allocations "https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_10_allocations.dart"
click node_figure "https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_11_explain_figure.dart"
click node_guests "https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_12_guests_list.dart"
click node_guest_scenarios "https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_13_guest_what_if.dart"
click node_pledges "https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_14_pledges_list.dart"
click node_pledge_editor "https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_15_pledge_editor.dart"
click node_change_log "https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_16_change_log.dart"
click node_shared_access "https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_17_shared_access.dart"
click node_plan_settings "https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_18_plan_settings.dart"
click node_sync_detail "https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_19_sync_detail.dart"
click node_push "https://github.com/rhon-dev/kasaran-app/blob/main/supabase/functions/sync_push/index.ts"
click node_pull "https://github.com/rhon-dev/kasaran-app/blob/main/supabase/functions/sync_pull/index.ts"
click node_auth "https://github.com/rhon-dev/kasaran-app/blob/main/supabase/functions/_shared/auth.ts"
click node_validation "https://github.com/rhon-dev/kasaran-app/blob/main/supabase/functions/_shared/validation.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_app toneBlue
class node_setup,node_region,node_fees_setup,node_dashboard,node_ledger,node_expense_editor,node_fee_editor,node_allocations,node_figure,node_guests,node_guest_scenarios,node_pledges,node_pledge_editor,node_supabase toneAmber
class node_change_log,node_shared_access,node_plan_settings,node_sync_detail toneMint
class node_push,node_pull,node_auth,node_validation toneRose
class node_couple toneIndigo
```

## Components

### Flutter client

- [App entry](https://github.com/rhon-dev/kasaran-app/blob/main/lib/main.dart): `lib/main.dart`

### Budget planning

- [Budget setup](https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_03_setup_budget_date.dart): `lib/ui/screens/scr_03_setup_budget_date.dart`
- [Region setup](https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_04_setup_guest_region.dart): `lib/ui/screens/scr_04_setup_guest_region.dart`
- [Fee setup](https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_05_setup_hidden_fees.dart): `lib/ui/screens/scr_05_setup_hidden_fees.dart`
- [Dashboard](https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_06_dashboard.dart): `lib/ui/screens/scr_06_dashboard.dart`
- [Expense ledger](https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_07_ledger_list.dart): `lib/ui/screens/scr_07_ledger_list.dart`
- [Expense editor](https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_08_expense_editor.dart): `lib/ui/screens/scr_08_expense_editor.dart`
- [Fee editor](https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_09_hidden_fee_editor.dart): `lib/ui/screens/scr_09_hidden_fee_editor.dart`
- [Allocations](https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_10_allocations.dart): `lib/ui/screens/scr_10_allocations.dart`
- [Figure explainer](https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_11_explain_figure.dart): `lib/ui/screens/scr_11_explain_figure.dart`
- [Guest tracking](https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_12_guests_list.dart): `lib/ui/screens/scr_12_guests_list.dart`
- [Guest scenarios](https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_13_guest_what_if.dart): `lib/ui/screens/scr_13_guest_what_if.dart`
- [Pledge tracking](https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_14_pledges_list.dart): `lib/ui/screens/scr_14_pledges_list.dart`
- [Pledge editor](https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_15_pledge_editor.dart): `lib/ui/screens/scr_15_pledge_editor.dart`

### Shared plan

- [Change log](https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_16_change_log.dart): `lib/ui/screens/scr_16_change_log.dart`
- [Shared access](https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_17_shared_access.dart): `lib/ui/screens/scr_17_shared_access.dart`
- [Plan settings](https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_18_plan_settings.dart): `lib/ui/screens/scr_18_plan_settings.dart`
- [Sync detail](https://github.com/rhon-dev/kasaran-app/blob/main/lib/ui/screens/scr_19_sync_detail.dart): `lib/ui/screens/scr_19_sync_detail.dart`

### Sync backend

- [Sync push](https://github.com/rhon-dev/kasaran-app/blob/main/supabase/functions/sync_push/index.ts): `supabase/functions/sync_push/index.ts`
- [Sync pull](https://github.com/rhon-dev/kasaran-app/blob/main/supabase/functions/sync_pull/index.ts): `supabase/functions/sync_pull/index.ts`
- [Auth helper](https://github.com/rhon-dev/kasaran-app/blob/main/supabase/functions/_shared/auth.ts): `supabase/functions/_shared/auth.ts`
- [Push validation](https://github.com/rhon-dev/kasaran-app/blob/main/supabase/functions/_shared/validation.ts): `supabase/functions/_shared/validation.ts`

### Other components

- **Couple**
- **Supabase Auth**

## Connections

- Couple → App entry: uses
- App entry → Budget setup: starts planning
- Budget setup → Region setup: sets region
- Region setup → Fee setup: prompts fees
- Couple → Dashboard: reviews budget
- Couple → Expense ledger: tracks expenses
- Expense ledger → Expense editor: edits items
- Couple → Fee editor: records fees
- Couple → Allocations: reviews allocation
- Allocations → Figure explainer: explains figures
- Couple → Guest tracking: tracks guests
- Guest tracking → Guest scenarios: previews changes
- Couple → Pledge tracking: tracks pledges
- Pledge tracking → Pledge editor: edits pledges
- Couple → Shared access: shares plan
- Couple → Change log: reviews changes
- Couple → Plan settings: configures plan
- Couple → Sync detail: reviews sync
- Sync push → Auth helper: authenticates with (evidence: `supabase/functions/sync_push/index.ts`)
- Sync push → Push validation: validates body (evidence: `supabase/functions/sync_push/index.ts`)
- Sync pull → Auth helper: authenticates with (evidence: `supabase/functions/sync_pull/index.ts`)
- Auth helper → Supabase Auth: verifies user (evidence: `supabase/functions/_shared/auth.ts`)
- App entry → Sync push: sends changes
- App entry → Sync pull: requests changes
