# pavannauhwar-git/kosha architecture

> Architecture diagram of the GitHub repository pavannauhwar-git/kosha, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pavannauhwar-git/kosha
- Repository: https://github.com/pavannauhwar-git/kosha

## Overview

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: [`src/components/app/AppRoutes.jsx`](https://github.com/pavannauhwar-git/kosha/blob/main/src/components/app/AppRoutes.jsx) (Route dispatch), [`src/hooks/useTransactions.js`](https://github.com/pavannauhwar-git/kosha/blob/main/src/hooks/useTransactions.js) (Transaction data), [`src/hooks/useSplitwise.js`](https://github.com/pavannauhwar-git/kosha/blob/main/src/hooks/useSplitwise.js) (Splitwise groups), [`src/pages/Dashboard.jsx`](https://github.com/pavannauhwar-git/kosha/blob/main/src/pages/Dashboard.jsx) (Financial dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experience"]
  node_app["App shell<br/>[App.jsx]"]
  node_routes["Route dispatch<br/>[AppRoutes.jsx]"]
end

subgraph group_finance["Financial workflows"]
  node_dashboard["Financial dashboard<br/>[Dashboard.jsx]"]
  node_transactions["Transactions<br/>[Transactions.jsx]"]
  node_obligations["Bills and loans<br/>[Obligations.jsx]"]
  node_splitwise["Splitwise groups<br/>[useSplitwise.js]"]
  node_splitwise_page["Splitwise interface<br/>[Splitwise.jsx]"]
  node_reconciliation["Statement reconciliation<br/>[Reconciliation.jsx]"]
  node_analytics["Financial analytics<br/>[Analytics.jsx]"]
end

subgraph group_data["Data and state"]
  node_auth["Authentication<br/>[useAuth.js]"]
  node_transaction_data["Transaction data<br/>[useTransactions.js]"]
  node_liabilities["Liability data<br/>[useLiabilities.js]"]
  node_loans["Loan data<br/>[useLoans.js]"]
  node_reviews["Review queue"]
  node_categories["Category data"]
  node_query["Query and cache<br/>[queryClient.js]"]
  node_wallet["Wallet selection<br/>[walletStore.js]"]
end

subgraph group_platform["Services and observability"]
  node_audit["Financial audit log<br/>[auditLog.js]"]
  node_supabase[("Supabase backend")]
end

node_user(("Finance user"))

node_user -->|"opens"| node_app
node_app -->|"renders"| node_routes
node_routes -->|"guards routes"| node_auth
node_routes -->|"routes to"| node_dashboard
node_routes -->|"routes to"| node_transactions
node_routes -->|"routes to"| node_obligations
node_routes -->|"routes to"| node_splitwise_page
node_routes -->|"routes to"| node_reconciliation
node_routes -->|"routes to"| node_analytics
node_dashboard -->|"queries"| node_transaction_data
node_dashboard -->|"queries"| node_liabilities
node_transactions -->|"queries"| node_transaction_data
node_obligations -->|"manages"| node_liabilities
node_obligations -->|"manages"| node_loans
node_splitwise_page -->|"uses"| node_splitwise
node_reconciliation -->|"reviews transactions"| node_transaction_data
node_reconciliation -->|"loads reviews"| node_reviews
node_analytics -.->|"analyzes"| node_transaction_data
node_transaction_data -->|"reads and writes"| node_supabase
node_splitwise -->|"reads and writes"| node_supabase
node_reviews -->|"reads and writes"| node_supabase
node_transaction_data -->|"uses cache"| node_query
node_splitwise -->|"logs events"| node_audit
node_transaction_data -->|"scopes data"| node_wallet
node_splitwise -->|"scopes data"| node_wallet
node_transactions -->|"uses categories"| node_categories

click node_app "https://github.com/pavannauhwar-git/kosha/blob/main/src/App.jsx"
click node_routes "https://github.com/pavannauhwar-git/kosha/blob/main/src/components/app/AppRoutes.jsx"
click node_auth "https://github.com/pavannauhwar-git/kosha/blob/main/src/hooks/useAuth.js"
click node_dashboard "https://github.com/pavannauhwar-git/kosha/blob/main/src/pages/Dashboard.jsx"
click node_transactions "https://github.com/pavannauhwar-git/kosha/blob/main/src/pages/Transactions.jsx"
click node_transaction_data "https://github.com/pavannauhwar-git/kosha/blob/main/src/hooks/useTransactions.js"
click node_obligations "https://github.com/pavannauhwar-git/kosha/blob/main/src/pages/Obligations.jsx"
click node_liabilities "https://github.com/pavannauhwar-git/kosha/blob/main/src/hooks/useLiabilities.js"
click node_loans "https://github.com/pavannauhwar-git/kosha/blob/main/src/hooks/useLoans.js"
click node_splitwise "https://github.com/pavannauhwar-git/kosha/blob/main/src/hooks/useSplitwise.js"
click node_splitwise_page "https://github.com/pavannauhwar-git/kosha/blob/main/src/pages/Splitwise.jsx"
click node_reconciliation "https://github.com/pavannauhwar-git/kosha/blob/main/src/pages/Reconciliation.jsx"
click node_reviews "https://github.com/pavannauhwar-git/kosha/blob/main/src/hooks/useReconciliationReviews.js"
click node_analytics "https://github.com/pavannauhwar-git/kosha/blob/main/src/pages/Analytics.jsx"
click node_categories "https://github.com/pavannauhwar-git/kosha/blob/main/src/hooks/useUserCategories.js"
click node_query "https://github.com/pavannauhwar-git/kosha/blob/main/src/lib/queryClient.js"
click node_wallet "https://github.com/pavannauhwar-git/kosha/blob/main/src/lib/walletStore.js"
click node_audit "https://github.com/pavannauhwar-git/kosha/blob/main/src/lib/auditLog.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_routes,node_user toneBlue
class node_dashboard,node_transactions,node_obligations,node_splitwise,node_splitwise_page,node_reconciliation,node_analytics toneAmber
class node_auth,node_transaction_data,node_liabilities,node_loans,node_reviews,node_categories,node_query,node_wallet toneMint
class node_audit,node_supabase toneRose
```

## Components

### App experience

- [App shell](https://github.com/pavannauhwar-git/kosha/blob/main/src/App.jsx): `src/App.jsx`
- [Route dispatch](https://github.com/pavannauhwar-git/kosha/blob/main/src/components/app/AppRoutes.jsx): `src/components/app/AppRoutes.jsx`

### Financial workflows

- [Financial dashboard](https://github.com/pavannauhwar-git/kosha/blob/main/src/pages/Dashboard.jsx): `src/pages/Dashboard.jsx`
- [Transactions](https://github.com/pavannauhwar-git/kosha/blob/main/src/pages/Transactions.jsx): `src/pages/Transactions.jsx`
- [Bills and loans](https://github.com/pavannauhwar-git/kosha/blob/main/src/pages/Obligations.jsx): `src/pages/Obligations.jsx`
- [Splitwise groups](https://github.com/pavannauhwar-git/kosha/blob/main/src/hooks/useSplitwise.js): `src/hooks/useSplitwise.js`
- [Splitwise interface](https://github.com/pavannauhwar-git/kosha/blob/main/src/pages/Splitwise.jsx): `src/pages/Splitwise.jsx`
- [Statement reconciliation](https://github.com/pavannauhwar-git/kosha/blob/main/src/pages/Reconciliation.jsx): `src/pages/Reconciliation.jsx`
- [Financial analytics](https://github.com/pavannauhwar-git/kosha/blob/main/src/pages/Analytics.jsx): `src/pages/Analytics.jsx`

### Data and state

- [Authentication](https://github.com/pavannauhwar-git/kosha/blob/main/src/hooks/useAuth.js): `src/hooks/useAuth.js`
- [Transaction data](https://github.com/pavannauhwar-git/kosha/blob/main/src/hooks/useTransactions.js): `src/hooks/useTransactions.js`
- [Liability data](https://github.com/pavannauhwar-git/kosha/blob/main/src/hooks/useLiabilities.js): `src/hooks/useLiabilities.js`
- [Loan data](https://github.com/pavannauhwar-git/kosha/blob/main/src/hooks/useLoans.js): `src/hooks/useLoans.js`
- [Review queue](https://github.com/pavannauhwar-git/kosha/blob/main/src/hooks/useReconciliationReviews.js): `src/hooks/useReconciliationReviews.js`
- [Category data](https://github.com/pavannauhwar-git/kosha/blob/main/src/hooks/useUserCategories.js): `src/hooks/useUserCategories.js`
- [Query and cache](https://github.com/pavannauhwar-git/kosha/blob/main/src/lib/queryClient.js): `src/lib/queryClient.js`
- [Wallet selection](https://github.com/pavannauhwar-git/kosha/blob/main/src/lib/walletStore.js): `src/lib/walletStore.js`

### Services and observability

- [Financial audit log](https://github.com/pavannauhwar-git/kosha/blob/main/src/lib/auditLog.js): `src/lib/auditLog.js`
- **Supabase backend**

### Other components

- **Finance user**

## Connections

- Finance user → App shell: opens
- App shell → Route dispatch: renders (evidence: `src/App.jsx`)
- Route dispatch → Authentication: guards routes (evidence: `src/components/app/AppRoutes.jsx`)
- Route dispatch → Financial dashboard: routes to (evidence: `src/components/app/AppRoutes.jsx`)
- Route dispatch → Transactions: routes to (evidence: `src/components/app/AppRoutes.jsx`)
- Route dispatch → Bills and loans: routes to (evidence: `src/components/app/AppRoutes.jsx`)
- Route dispatch → Splitwise interface: routes to (evidence: `src/components/app/AppRoutes.jsx`)
- Route dispatch → Statement reconciliation: routes to (evidence: `src/components/app/AppRoutes.jsx`)
- Route dispatch → Financial analytics: routes to (evidence: `src/components/app/AppRoutes.jsx`)
- Financial dashboard → Transaction data: queries (evidence: `src/pages/Dashboard.jsx`)
- Financial dashboard → Liability data: queries (evidence: `src/pages/Dashboard.jsx`)
- Transactions → Transaction data: queries (evidence: `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 (evidence: `src/pages/Reconciliation.jsx`)
- Statement reconciliation → Review queue: loads reviews (evidence: `src/pages/Reconciliation.jsx`)
- Financial analytics → Transaction data: analyzes
- Transaction data → Supabase backend: reads and writes (evidence: `src/hooks/useTransactions.js`)
- Splitwise groups → Supabase backend: reads and writes (evidence: `src/hooks/useSplitwise.js`)
- Review queue → Supabase backend: reads and writes (evidence: `src/hooks/useReconciliationReviews.js`)
- Transaction data → Query and cache: uses cache (evidence: `src/hooks/useTransactions.js`)
- Splitwise groups → Financial audit log: logs events (evidence: `src/hooks/useSplitwise.js`)
- Transaction data → Wallet selection: scopes data (evidence: `src/hooks/useTransactions.js`)
- Splitwise groups → Wallet selection: scopes data (evidence: `src/hooks/useSplitwise.js`)
- Transactions → Category data: uses categories (evidence: `src/pages/Transactions.jsx`)
