How greenbinjack/finance-tracker works
Finance Tracker is a personal-finance PWA. Users sign in, then record and review everyday transactions; the dashboard summarizes balances and activity, while reports filter and analyze history. Separate branches cover budgets, investments, loans, and event/trip planning with shared expenses. Server-side services use Supabase for persistence and authentication; export routes provide JSON backups and CSV reports. The graph follows the README and supplied excerpts/index; unsampled feature internals are represented by their exact route paths, and their connections are not inferred beyond documented capabilities.
Main entry points: server.ts Server client · page.tsx Reports · transactions.ts Transaction services · route.ts Export routes
Components 24
Access and shell
- Sign in
src/app/login/page.tsx - Auth actions
src/app/login/actions.ts - Settings
src/app/(app)/settings/actions.ts
Personal finances
- Finance dashboard
src/app/(app)/page.tsx - Transactions
src/app/(app)/transactions/page.tsx - Accounts
src/lib/services/accounts.ts - Budgets
src/app/(app)/budgets/page.tsx - Investments
src/app/(app)/investments/page.tsx - Loans
src/app/(app)/loans/page.tsx
Planning and sharing
- Events and trips
src/app/(app)/events/page.tsx - Shared trip view
src/app/trips/[token]/page.tsx
Reports and export
- Reports
src/app/(app)/reports/page.tsx - CSV formatting
src/lib/domain/csv.ts - Export routes
src/app/api/export/reports/route.ts - Data backup
src/app/api/export/data/route.ts
Data and services
- Transaction services
src/lib/services/transactions.ts - Server client
src/lib/supabase/server.ts - Supabase
- Database types
src/lib/supabase/database.types.ts - Dashboard service
src/lib/services/dashboard.ts - Recurring detection
src/lib/domain/recurring.ts - Profile service
src/lib/services/profile.ts - Event service
src/lib/services/events.ts
Other components
- User
Connections 27
- User → Sign in: signs in
- Sign in → Auth actions: submits credentials
src/app/login/page.tsx - Auth actions → Server client: authenticates
src/app/login/actions.ts - Finance dashboard → Dashboard service: loads summary
src/app/(app)/page.tsx - Finance dashboard → Recurring detection: detects patterns
src/app/(app)/page.tsx - Dashboard service → Server client: queries data
- Transactions → Transaction services: lists history
- Reports → Transaction services: requests summaries
src/app/(app)/reports/page.tsx - Reports → Profile service: loads currency
src/app/(app)/reports/page.tsx - Reports → Accounts: loads accounts
src/app/(app)/reports/page.tsx - Reports → Event service: loads events
src/app/(app)/reports/page.tsx - Transaction services → Server client: queries transactions
src/lib/services/transactions.ts - Server client → Database types: types client
src/lib/supabase/server.ts - Server client → Supabase: connects
src/lib/supabase/server.ts - Settings → Profile service: updates profile
src/app/(app)/settings/actions.ts - Settings → Accounts: manages accounts
src/app/(app)/settings/actions.ts - User → Budgets: sets budgets
- User → Investments: tracks investments
- User → Loans: tracks loans
- User → Events and trips: plans trips
- Events and trips → Shared trip view: shares trip
- User → Reports: reviews reports
- User → Export routes: downloads CSV
- Export routes → Transaction services: loads filtered data
src/app/api/export/reports/route.ts - Export routes → CSV formatting: formats CSV
src/app/api/export/reports/route.ts - User → Data backup: downloads backup
- Data backup → Server client: reads records
src/app/api/export/data/route.ts