How isaac-priyadarshan/finance-diary works
Clear Budget Flow is a two-person personal-finance app for tracking spending, accounts, obligations, and investments. The principal workflow is profile selection, navigation to a finance screen, then reading or changing typed financial data through server functions backed by Supabase. Separate branches cover budgeting and transactions, personal ledgers and accounts, asset pricing, planning, and category customization. The graph follows documented capabilities and sampled references; unsampled screen-to-data wiring is not inferred.
Main entry points: queries.ts Query definitions · db.server.ts Server database access · market.functions.ts Instrument lookup · index.tsx App entry
Components 25
App experience
- App entry
src/routes/index.tsx - Profile identity
src/components/app/IdentityProvider.tsx - Remembered choices
src/hooks/useRemembered.ts - Navigation shell
src/components/app/AppShell.tsx - Finance screens
src/components/screens
Money tracking
- Transactions and budgets
src/lib/transactions.functions.ts - Budget tracking
src/lib/budgets.functions.ts - Wallets and accounts
src/lib/accounts.functions.ts - Borrowed and lent
src/lib/person-entries.functions.ts - Category studio
src/lib/category-studio.functions.ts - Category manager
src/components/settings/CategoryManager.tsx
Planning and assets
- Asset tracking
src/lib/assets.functions.ts - Instrument lookup
src/lib/market.functions.ts - Market providers
src/lib/market-providers.server.ts - Planning data
src/lib/planning.functions.ts - Planning views
src/components/planning/PlanningViews.tsx
Data and services
- Query definitions
src/lib/queries.ts - Server database access
src/lib/db.server.ts - Supabase database
- Price sync endpoint
src/routes/api/public/hooks/sync-prices.ts - Price synchronization
src/lib/price-sync.server.ts
Other components
- Two-person user
- Yahoo Finance
- mfapi.in
- CoinGecko
Connections 29
- Two-person user → App entry: opens app
- App entry → Profile identity: checks profile
src/routes/index.tsx - App entry → Navigation shell: renders
src/routes/index.tsx - App entry → Finance screens: selects screen
- Profile identity → Remembered choices: provides profile
src/hooks/useRemembered.ts - Navigation shell → Finance screens: routes screens
src/components/app/AppShell.tsx - Two-person user → Finance screens: tracks finances
- Query definitions → Transactions and budgets: queries
src/lib/queries.ts - Query definitions → Budget tracking: queries
src/lib/queries.ts - Query definitions → Wallets and accounts: queries
src/lib/queries.ts - Query definitions → Borrowed and lent: queries
src/lib/queries.ts - Query definitions → Asset tracking: queries
src/lib/queries.ts - Query definitions → Planning data: queries
- Category manager → Category studio: loads categories
src/components/settings/CategoryManager.tsx - Category manager → Profile identity: reads profile
src/components/settings/CategoryManager.tsx - Planning views → Planning data: loads planning
src/components/planning/PlanningViews.tsx - Planning views → Two-person user: shows projections
- Instrument lookup → Market providers: uses providers
src/lib/market.functions.ts - Instrument lookup → Yahoo Finance: fetches quotes
- Instrument lookup → mfapi.in: fetches quotes
- Instrument lookup → CoinGecko: fetches quotes
- Price sync endpoint → Price synchronization: dispatches sync
src/routes/api/public/hooks/sync-prices.ts - Price synchronization → Asset tracking: updates prices
- Transactions and budgets → Server database access: reads and writes
- Budget tracking → Server database access: reads and writes
- Wallets and accounts → Server database access: reads and writes
- Borrowed and lent → Server database access: reads and writes
src/lib/person-entries.functions.ts - Planning data → Server database access: reads and writes
src/lib/planning.functions.ts - Server database access → Supabase database: accesses data