How rohitkf/aureal_finance_ai works
Aureal Finance AI is a personal-finance web app centered on calculating Safe to Spend from account balances, expected income, commitments, and a protected minimum. The user signs in, enters accounts and transactions (including recurring items), then reviews the resulting position across the dashboard and planning screens. The README documents budgeting, forecasting, goals, debts, reports, search, and data export; these are represented as product branches. Source excerpts were limited, so some page-to-engine wiring is documented rather than directly sampled; uncertain calls are omitted.
Main entry points: AppShell.tsx App shell · store.tsx App data store · App.tsx App routing · finance.ts Finance calculations
Components 23
App and access
- App routing
src/App.tsx - Auth provider
src/lib/auth.tsx - Sign-in flows
src/pages/auth - App shell
src/components/AppShell.tsx
Money management
- Dashboard
src/pages/Dashboard.tsx - Accounts
src/pages/Accounts.tsx - Account detail
src/pages/AccountDetail.tsx - Transactions
src/pages/Transactions.tsx - Transaction entry
src/components/AddTransactionSheet.tsx - Recurring payments
src/pages/Recurring.tsx
Planning and insight
- Budget
src/pages/Budget.tsx - Forecast
src/pages/Forecast.tsx - Goals
src/pages/Goals.tsx - Debts
src/pages/Debts.tsx - Reports
src/pages/Reports.tsx - Settings and export
src/pages/Settings.tsx - Global search
src/components/CommandPalette.tsx
Data and finance engine
- App data store
src/lib/store.tsx - Finance calculations
src/lib/finance.ts - Recurrence expansion
src/lib/recurrence.ts - Supabase service
src/lib/supabase.ts - Supabase database
Other components
- User
Connections 38
- User → App routing: opens app
- App routing → Auth provider: checks session
- App routing → Sign-in flows: routes auth
- Sign-in flows → Auth provider: authenticates
- Auth provider → Supabase service: auth requests
- App routing → App shell: renders protected routes
- App shell → Dashboard: shows home
- App shell → Accounts: routes to
- App shell → Account detail: routes to
- App shell → Transactions: routes to
- App shell → Budget: routes to
- App shell → Forecast: routes to
- App shell → Recurring payments: routes to
- App shell → Goals: routes to
- App shell → Debts: routes to
- App shell → Reports: routes to
- App shell → Settings and export: routes to
- App shell → Global search: provides search
- Transactions → Transaction entry: opens entry
- Transaction entry → App data store: dispatches changes
- App data store → Supabase service: loads and saves
- Supabase service → Supabase database: reads and writes
- Dashboard → App data store: reads state
- Accounts → App data store: reads state
- Account detail → App data store: reads state
- Transactions → App data store: reads state
- Recurring payments → App data store: reads state
- Budget → App data store: reads state
- Forecast → App data store: reads state
- Goals → App data store: reads state
- Debts → App data store: reads state
- Reports → App data store: reads state
- Settings and export → App data store: manages data
- Dashboard → Finance calculations: calculates position
- Budget → Finance calculations: calculates progress
- Forecast → Finance calculations: builds projections
- Recurring payments → Recurrence expansion: expands schedules
- Finance calculations → Recurrence expansion: expands forecast rules