How vj-ashwin/the_good_treasurer works
The tree and sampled code describe a trip-based expense-sharing app: a signed-in user creates or selects a trip, manages people and expenses, then reviews history or reports. The README instead describes an earlier personal-ledger feature set, so the map follows the richer trip workflow evidenced by the source index and excerpts. Firestore provides persistence and live subscriptions; the money layer handles paise, taxes, splits, balances, settlements, and reports. Some panel and storage internals were not excerpted, so their connections are limited to visible imports and documented capabilities.
Main entry points: TripDetailPage.tsx Trip detail · App.tsx App routing · ReportPanel.tsx Reporting · index.ts Money calculations
Components 27
App and navigation
- App routing
src/App.tsx - Sign-in page
src/pages/SignInPage.tsx - Auth state
src/hooks/useAuth.ts
Trip workspace
- Trip list
src/pages/TripListPage.tsx - Workspace shell
src/components/AppShell.tsx - Trip creation
src/components/CreateTripDialog.tsx - Trip detail
src/pages/TripDetailPage.tsx - People management
src/components/PeoplePanel.tsx - Expense ledger
src/components/ExpensesPanel.tsx - Trip history
src/components/HistoryPanel.tsx
Firestore data
- Trip data hooks
src/hooks/useTrips.ts - Trip and people storage
src/lib/firestore/trips.ts - People storage
src/lib/firestore/people.ts - Expense and history storage
src/lib/firestore/expenses.ts - Firestore database
src/lib/firebase.ts
Expense calculations
- Expense input parsing
src/lib/expenseInput.ts - Money calculations
src/lib/money/index.ts - Paise and formatting
src/lib/money/paise.ts - Splits and tax
src/lib/money/split.ts - Tax calculation
src/lib/money/tax.ts
Reports and exports
- Reporting
src/components/ReportPanel.tsx - Data backup
src/lib/export/backup.ts - PDF report export
src/lib/export/reportPdf.tsx - PNG report export
src/lib/export/reportPng.ts
Other components
- Treasurer
- Google sign-in
- Firebase services
Connections 32
- Treasurer → App routing: uses
src/App.tsx - App routing → Auth state: checks sign-in
src/App.tsx - App routing → Sign-in page: routes to
src/App.tsx - App routing → Trip list: routes to
src/App.tsx - App routing → Trip detail: routes to
src/App.tsx - Sign-in page → Auth state: signs in
src/pages/SignInPage.tsx - Auth state → Google sign-in: authenticates with
src/hooks/useAuth.ts - Auth state → Firebase services: tracks session
src/hooks/useAuth.ts - Trip list → Workspace shell: renders
src/pages/TripListPage.tsx - Workspace shell → Trip data hooks: loads trips
src/components/AppShell.tsx - Workspace shell → Trip creation: opens
src/components/AppShell.tsx - Trip creation → Trip and people storage: creates trips
src/components/CreateTripDialog.tsx - Trip detail → Workspace shell: renders
src/pages/TripDetailPage.tsx - Trip detail → People management: shows people
src/pages/TripDetailPage.tsx - Trip detail → Expense ledger: shows expenses
src/pages/TripDetailPage.tsx - Trip detail → Trip history: shows history
src/pages/TripDetailPage.tsx - Trip detail → Reporting: shows reports
src/pages/TripDetailPage.tsx - Trip data hooks → Trip and people storage: watches trips
- Trip data hooks → Firestore database: uses database
src/hooks/useTrips.ts - People management → People storage: manages people
- Expense ledger → Expense and history storage: writes expenses
src/components/ExpensesPanel.tsx - Expense ledger → Expense input parsing: parses entries
src/components/ExpensesPanel.tsx - Expense ledger → Money calculations: uses calculations
src/components/ExpensesPanel.tsx - Trip history → Expense and history storage: loads history
- Reporting → Data backup: exports backup
src/components/ReportPanel.tsx - Reporting → PDF report export: exports PDF
src/components/ReportPanel.tsx - Reporting → PNG report export: exports image
src/components/ReportPanel.tsx - Reporting → Money calculations: builds summaries
src/components/ReportPanel.tsx - Money calculations → Paise and formatting: exports helpers
src/lib/money/index.ts - Money calculations → Splits and tax: exports helpers
src/lib/money/index.ts - Money calculations → Tax calculation: exports helpers
src/lib/money/index.ts - Firestore database → Firebase services: connects to