How virtiparekh/cash-book works
Family Cash Book is a React and Supabase app for managing independent family cash books. A user signs in, selects or creates a book, then records and reviews transactions; related workflows cover members and invitations, recurring entries, reports, and book settings. The graph groups the major user-facing stages and the service/data-access layer. Some page and feature internals were not sampled, so those branches reflect README capabilities and are not expanded into unverified call chains.
Main entry points: supabase.ts Supabase client · AppRoutes.tsx App routing · DashboardPage.tsx Book dashboard · SettingsPage.tsx Book settings
Components 22
App entry
- App routing
src/routes/AppRoutes.tsx - Authentication state
src/contexts/AuthContext.tsx
Cash book setup
- Selected book state
src/contexts/CashBookContext.tsx - Book selection
src/hooks/useCashBookGroups.ts - Create a book
src/pages/CashBookSetupPage.tsx
Financial activity
- Book dashboard
src/pages/DashboardPage.tsx - Transaction history
src/components/dashboard/TransactionTable/TransactionTable.tsx - Transaction entry
src/components/dashboard/TransactionDrawer/TransactionForm.tsx - Recurring entries
src/components/recurring/RecurringTransactionForm.tsx - Reports and summaries
src/pages/ReportsPage.tsx
Book administration
- Member management
src/pages/MembersPage.tsx - Invitation acceptance
src/pages/AcceptInvitationPage.tsx - Book settings
src/pages/SettingsPage.tsx
Services and storage
- Supabase client
src/lib/supabase.ts - Book data service
src/services/groupService.ts - Book management service
src/services/cashBookService.ts - Transaction service
src/services/transactionService.ts - Recurring service
src/services/recurringTransactionService.ts - Member service
src/services/memberService.ts - Invitation service
src/services/invitationService.ts - Categories and payment modes
src/services/masterDataService.ts
Other components
- Family user
Connections 31
- Family user → App routing: opens app
src/routes/AppRoutes.tsx - App routing → Authentication state: reads session
src/routes/AppRoutes.tsx - Authentication state → Supabase client: auth calls
src/contexts/AuthContext.tsx - App routing → Book selection: loads books
src/routes/AppRoutes.tsx - Book selection → Book data service: loads memberships
src/hooks/useCashBookGroups.ts - Book data service → Supabase client: queries data
src/services/groupService.ts - App routing → Selected book state: selects book
src/routes/AppRoutes.tsx - Selected book state → Member service: loads member
src/contexts/CashBookContext.tsx - Member service → Supabase client: queries members
src/services/memberService.ts - App routing → Create a book: routes setup
src/routes/AppRoutes.tsx - Create a book → Book management service: creates book
src/pages/CashBookSetupPage.tsx - Book management service → Supabase client: persists book
- App routing → Book dashboard: routes selected book
src/routes/AppRoutes.tsx - Book dashboard → Transaction history: renders history
src/pages/DashboardPage.tsx - Book dashboard → Transaction entry: opens entry
src/pages/DashboardPage.tsx - Book dashboard → Transaction service: loads transactions
src/pages/DashboardPage.tsx - Transaction service → Supabase client: reads and writes
src/services/transactionService.ts - Family user → Recurring entries: manages repeats
- Recurring entries → Recurring service: manages schedules
src/components/recurring/RecurringTransactionForm.tsx - Recurring service → Supabase client: stores schedules
src/services/recurringTransactionService.ts - Family user → Reports and summaries: views summaries
- Family user → Member management: manages family
- Member management → Member service: updates members
src/pages/MembersPage.tsx - Member management → Invitation service: sends invitations
src/pages/MembersPage.tsx - Invitation service → Supabase client: stores invitations
src/services/invitationService.ts - Family user → Invitation acceptance: accepts invite
- Family user → Book settings: configures book
- Book settings → Book data service: manages books
src/pages/SettingsPage.tsx - Book settings → Book management service: duplicates book
src/pages/SettingsPage.tsx - Book settings → Categories and payment modes: manages categories
src/pages/SettingsPage.tsx - Categories and payment modes → Supabase client: stores options
src/services/masterDataService.ts