How rhon-dev/kasaran-app works
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: main.dart App entry · index.ts Sync push · auth.ts Auth helper · scr_03_setup_budget_date.dart Budget setup
Components 24
Flutter client
- App entry
lib/main.dart
Budget planning
- Budget setup
lib/ui/screens/scr_03_setup_budget_date.dart - Region setup
lib/ui/screens/scr_04_setup_guest_region.dart - Fee setup
lib/ui/screens/scr_05_setup_hidden_fees.dart - Dashboard
lib/ui/screens/scr_06_dashboard.dart - Expense ledger
lib/ui/screens/scr_07_ledger_list.dart - Expense editor
lib/ui/screens/scr_08_expense_editor.dart - Fee editor
lib/ui/screens/scr_09_hidden_fee_editor.dart - Allocations
lib/ui/screens/scr_10_allocations.dart - Figure explainer
lib/ui/screens/scr_11_explain_figure.dart - Guest tracking
lib/ui/screens/scr_12_guests_list.dart - Guest scenarios
lib/ui/screens/scr_13_guest_what_if.dart - Pledge tracking
lib/ui/screens/scr_14_pledges_list.dart - Pledge editor
lib/ui/screens/scr_15_pledge_editor.dart
Shared plan
- Change log
lib/ui/screens/scr_16_change_log.dart - Shared access
lib/ui/screens/scr_17_shared_access.dart - Plan settings
lib/ui/screens/scr_18_plan_settings.dart - Sync detail
lib/ui/screens/scr_19_sync_detail.dart
Sync backend
- Sync push
supabase/functions/sync_push/index.ts - Sync pull
supabase/functions/sync_pull/index.ts - Auth helper
supabase/functions/_shared/auth.ts - Push validation
supabase/functions/_shared/validation.ts
Other components
- Couple
- Supabase Auth
Connections 24
- 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
supabase/functions/sync_push/index.ts - Sync push → Push validation: validates body
supabase/functions/sync_push/index.ts - Sync pull → Auth helper: authenticates with
supabase/functions/sync_pull/index.ts - Auth helper → Supabase Auth: verifies user
supabase/functions/_shared/auth.ts - App entry → Sync push: sends changes
- App entry → Sync pull: requests changes