How pavannauhwar-git/kosha works
Kosha is a mobile-first personal-finance PWA. A signed-in user enters through the application shell and routes to transaction, obligation, Splitwise, reconciliation, dashboard, and analytics workflows. Domain hooks coordinate financial data operations with Supabase and React Query; auth and wallet state scope access, while the query client manages caching and error reporting. The README documents offline-friendly support, linked wallets, audit logging, and statement matching. Some feature implementations were not sampled, so their documented capabilities are shown without speculative internal call chains.
Main entry points: AppRoutes.jsx Route dispatch · useTransactions.js Transaction data · useSplitwise.js Splitwise groups · Dashboard.jsx Financial dashboard
Components 20
App experience
- App shell
src/App.jsx - Route dispatch
src/components/app/AppRoutes.jsx
Financial workflows
- Financial dashboard
src/pages/Dashboard.jsx - Transactions
src/pages/Transactions.jsx - Bills and loans
src/pages/Obligations.jsx - Splitwise groups
src/hooks/useSplitwise.js - Splitwise interface
src/pages/Splitwise.jsx - Statement reconciliation
src/pages/Reconciliation.jsx - Financial analytics
src/pages/Analytics.jsx
Data and state
- Authentication
src/hooks/useAuth.js - Transaction data
src/hooks/useTransactions.js - Liability data
src/hooks/useLiabilities.js - Loan data
src/hooks/useLoans.js - Review queue
src/hooks/useReconciliationReviews.js - Category data
src/hooks/useUserCategories.js - Query and cache
src/lib/queryClient.js - Wallet selection
src/lib/walletStore.js
Services and observability
- Financial audit log
src/lib/auditLog.js - Supabase backend
Other components
- Finance user
Connections 26
- Finance user → App shell: opens
- App shell → Route dispatch: renders
src/App.jsx - Route dispatch → Authentication: guards routes
src/components/app/AppRoutes.jsx - Route dispatch → Financial dashboard: routes to
src/components/app/AppRoutes.jsx - Route dispatch → Transactions: routes to
src/components/app/AppRoutes.jsx - Route dispatch → Bills and loans: routes to
src/components/app/AppRoutes.jsx - Route dispatch → Splitwise interface: routes to
src/components/app/AppRoutes.jsx - Route dispatch → Statement reconciliation: routes to
src/components/app/AppRoutes.jsx - Route dispatch → Financial analytics: routes to
src/components/app/AppRoutes.jsx - Financial dashboard → Transaction data: queries
src/pages/Dashboard.jsx - Financial dashboard → Liability data: queries
src/pages/Dashboard.jsx - Transactions → Transaction data: queries
src/pages/Transactions.jsx - Bills and loans → Liability data: manages
- Bills and loans → Loan data: manages
- Splitwise interface → Splitwise groups: uses
- Statement reconciliation → Transaction data: reviews transactions
src/pages/Reconciliation.jsx - Statement reconciliation → Review queue: loads reviews
src/pages/Reconciliation.jsx - Financial analytics → Transaction data: analyzes
- Transaction data → Supabase backend: reads and writes
src/hooks/useTransactions.js - Splitwise groups → Supabase backend: reads and writes
src/hooks/useSplitwise.js - Review queue → Supabase backend: reads and writes
src/hooks/useReconciliationReviews.js - Transaction data → Query and cache: uses cache
src/hooks/useTransactions.js - Splitwise groups → Financial audit log: logs events
src/hooks/useSplitwise.js - Transaction data → Wallet selection: scopes data
src/hooks/useTransactions.js - Splitwise groups → Wallet selection: scopes data
src/hooks/useSplitwise.js - Transactions → Category data: uses categories
src/pages/Transactions.jsx