How bladureau/budget-app works
Budget is a local-first, single-user personal budgeting app: users maintain monthly income, subscriptions, expenses and envelopes, then review available funds and forecasts. The browser persists locally and can synchronize to a self-hosted server, with conflict handling; optional read-only bank sync imports classified card transactions. The graph preserves those domain stages and the bank authorization/import path. Evidence is limited to the README and SOURCE INDEX references plus shown excerpts; unsampled UI and sync details are represented only where documented.
Main entry points: budget-provider.tsx Budget state · client.ts Bank API client · connect/route.ts Bank authorization flow · operations/route.ts Operation retrieval
Components 30
Budget workspace
- Budget interface
src/app/page.tsx - Budget state
src/features/budget/budget-provider.tsx - Budget calculations
src/features/budget/calculs.ts - Monthly views
src/features/budget/components - Income and subscriptions
src/features/budget/components - Expense journal
src/features/budget/components/expense-journal.tsx - Spending envelopes
src/features/budget/envelopes.ts - Import and export
src/features/budget/transfer.ts
Client data
- Browser persistence
src/lib/storage.ts - Document validation
src/lib/budget-document.ts - Sync client
src/features/budget/sync.ts - Sync metadata
src/lib/sync-metadata.ts
Self-hosted storage
- Budget API
src/app/api/budget/route.ts - Device authorization
src/lib/server/authorization.ts - Server budget store
src/lib/server/budget-store.ts - Atomic file writes
src/lib/server/atomic-file.ts
Bank sync
- Bank controls
src/features/banking/components/bank-panel.tsx - Bank API client
src/features/banking/client.ts - Bank API routes
src/app/api/banking - Bank authorization flow
src/app/api/banking/connect/route.ts - Bank callback
src/app/api/banking/callback/route.ts - Pending authorization
src/lib/server/banking/pending-auth.ts - Enable Banking
src/lib/server/banking/enable-banking.ts - Operation retrieval
src/app/api/banking/operations/route.ts - Bank state store
src/lib/server/banking/banking-store.ts - Unclassified transactions
src/features/banking/components/inbox.tsx - Transaction rules
src/features/banking/rules.ts - Bank status
src/features/banking/bank-status.ts
Other components
- Budget user
- Connected bank
Connections 33
- Budget user → Budget interface: uses
README.md - Budget interface → Budget state: renders
src/app/page.tsx - Budget state → Monthly views: supplies state
src/features/budget/budget-provider.tsx - Budget user → Income and subscriptions: maintains
README.md - Budget user → Expense journal: records expenses
README.md - Budget user → Spending envelopes: sets limits
README.md - Budget state → Budget calculations: uses
src/features/budget/budget-provider.tsx - Budget state → Browser persistence: loads and saves
src/features/budget/budget-provider.tsx - Browser persistence → Document validation: validates documents
src/lib/storage.ts - Budget state → Sync metadata: reads and writes
src/features/budget/budget-provider.tsx - Budget state → Sync client: pushes and pulls
src/features/budget/budget-provider.tsx - Budget user → Import and export: backs up or restores
README.md - Sync client → Budget API: requests sync
- Budget API → Device authorization: checks access
src/app/api/budget/route.ts - Budget API → Server budget store: reads and writes
src/app/api/budget/route.ts - Server budget store → Atomic file writes: writes atomically
src/lib/server/budget-store.ts - Budget user → Bank controls: connects and syncs
README.md - Bank controls → Bank API client: requests bank actions
src/features/banking/components/bank-panel.tsx - Bank API client → Bank authorization flow: starts connection
src/features/banking/client.ts - Bank API client → Operation retrieval: fetches operations
src/features/banking/client.ts - Bank authorization flow → Device authorization: checks access
src/app/api/banking/connect/route.ts - Bank authorization flow → Pending authorization: creates state
src/app/api/banking/connect/route.ts - Bank authorization flow → Enable Banking: requests authorization
src/app/api/banking/connect/route.ts - Connected bank → Bank callback: returns authorization
README.md - Bank callback → Pending authorization: consumes state
src/app/api/banking/callback/route.ts - Bank callback → Enable Banking: completes connection
src/app/api/banking/callback/route.ts - Operation retrieval → Device authorization: checks access
src/app/api/banking/operations/route.ts - Operation retrieval → Enable Banking: fetches transactions
src/app/api/banking/operations/route.ts - Operation retrieval → Bank state store: reads and updates
src/app/api/banking/operations/route.ts - Bank API client → Unclassified transactions: provides transactions
- Unclassified transactions → Transaction rules: classifies transactions
- Bank controls → Bank status: displays status
src/features/banking/components/bank-panel.tsx - Budget state → Bank API client: imports operations
src/features/budget/budget-provider.tsx