# j12steve/chitieusmart architecture

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

- Interactive diagram: https://gitdiagram.com/j12steve/chitieusmart
- Repository: https://github.com/j12steve/chitieusmart

## Overview

This is a personal-finance tracking frontend: users add income or expenses, review transactions, see dashboard summaries and cashflow, and compare spending with category budgets. The main flow runs from the app shell through shared transaction state to feature pages and their views; budget and dashboard calculations derive results from transactions. Edges reflect shown app composition and source-index references; unsampled modules are represented only where the tree supports them, so some internal behavior is not detailed.

Main entry points: [`src/features/dashboard/DashboardPage.jsx`](https://github.com/j12steve/chitieusmart/blob/main/src/features/dashboard/DashboardPage.jsx) (Dashboard page), [`src/App.jsx`](https://github.com/j12steve/chitieusmart/blob/main/src/App.jsx) (App routing), [`src/features/transactions/TransactionsProvider.jsx`](https://github.com/j12steve/chitieusmart/blob/main/src/features/transactions/TransactionsProvider.jsx) (Transaction state), [`src/features/budgets/BudgetsPage.jsx`](https://github.com/j12steve/chitieusmart/blob/main/src/features/budgets/BudgetsPage.jsx) (Budgets page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_app["App routing<br/>[App.jsx]"]
  node_shell["App shell<br/>[AppShell.jsx]"]
  node_nav["Navigation<br/>[Navigation.jsx]"]
end

subgraph group_transactions["Transaction tracking"]
  node_provider["Transaction state"]
  node_txhook["Transaction access<br/>[useTransactions.js]"]
  node_txpage["Transactions page"]
  node_txform["Transaction form"]
  node_addmodal["Add transaction modal"]
  node_txlist["Transaction list"]
  node_txitem["Transaction item"]
  node_addbutton["Add button"]
end

subgraph group_insights["Finance insights"]
  node_dashboard["Dashboard page<br/>[DashboardPage.jsx]"]
  node_stats["Dashboard stats"]
  node_balance["Balance card<br/>[BalanceCard.jsx]"]
  node_summary["Summary stats<br/>[SummaryStats.jsx]"]
  node_chart["Cashflow chart<br/>[CashflowChart.jsx]"]
  node_budgetpage["Budgets page<br/>[BudgetsPage.jsx]"]
  node_budgethook["Budget calculations<br/>[useBudgets.js]"]
  node_budgetcard["Budget card<br/>[BudgetCard.jsx]"]
end

subgraph group_shared["Shared data and UI"]
  node_calculations["Finance calculations<br/>[calculations.js]"]
  node_categories["Categories<br/>[categories.js]"]
  node_seed["Seed data<br/>[seed.js]"]
  node_storage[("Browser storage<br/>[useLocalStorage.js]")]
  node_date["Date utilities<br/>[formatDate.js]"]
  node_currency["Currency formatting<br/>[formatCurrency.js]"]
  node_ui["Shared UI components<br/>[index.js]"]
  node_header["Page header<br/>[PageHeader.jsx]"]
  node_motion["Motion presets<br/>[motion.js]"]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"provides state"| node_provider
node_app -->|"renders"| node_shell
node_app -->|"renders"| node_dashboard
node_app -->|"renders"| node_txpage
node_app -->|"renders"| node_budgetpage
node_app -->|"renders"| node_addmodal
node_shell -->|"renders"| node_nav
node_provider -->|"persists state"| node_storage
node_provider -->|"loads defaults"| node_seed
node_provider -->|"uses"| node_calculations
node_provider -->|"provides context"| node_txhook
node_txpage -->|"reads state"| node_txhook
node_txpage -->|"renders"| node_addbutton
node_txpage -->|"renders"| node_txlist
node_addmodal -->|"uses"| node_txhook
node_addmodal -->|"renders"| node_txform
node_txlist -->|"renders"| node_txitem
node_dashboard -->|"reads state"| node_txhook
node_dashboard -->|"calculates"| node_stats
node_dashboard -->|"renders"| node_txlist
node_dashboard -->|"renders"| node_addbutton
node_dashboard -->|"renders"| node_balance
node_dashboard -->|"renders"| node_summary
node_dashboard -->|"renders"| node_chart
node_stats -->|"uses"| node_calculations
node_budgetpage -->|"reads state"| node_txhook
node_budgetpage -->|"calculates"| node_budgethook
node_budgetpage -->|"renders"| node_budgetcard
node_budgethook -->|"persists limits"| node_storage
node_budgethook -->|"loads defaults"| node_seed
node_budgethook -->|"aggregates spending"| node_calculations
node_calculations -->|"uses"| node_date
node_txform -->|"uses"| node_categories
node_txitem -->|"uses"| node_categories
node_txitem -->|"formats amounts"| node_currency
node_txitem -->|"formats dates"| node_date
node_budgetcard -->|"uses"| node_categories
node_budgetcard -->|"formats amounts"| node_currency
node_dashboard -->|"renders"| node_header
node_budgetpage -->|"renders"| node_header
node_dashboard -->|"uses"| node_ui

click node_app "https://github.com/j12steve/chitieusmart/blob/main/src/App.jsx"
click node_shell "https://github.com/j12steve/chitieusmart/blob/main/src/components/layout/AppShell.jsx"
click node_nav "https://github.com/j12steve/chitieusmart/blob/main/src/components/layout/Navigation.jsx"
click node_provider "https://github.com/j12steve/chitieusmart/blob/main/src/features/transactions/TransactionsProvider.jsx"
click node_txhook "https://github.com/j12steve/chitieusmart/blob/main/src/features/transactions/hooks/useTransactions.js"
click node_txpage "https://github.com/j12steve/chitieusmart/blob/main/src/features/transactions/TransactionsPage.jsx"
click node_txform "https://github.com/j12steve/chitieusmart/blob/main/src/features/transactions/components/TransactionForm.jsx"
click node_addmodal "https://github.com/j12steve/chitieusmart/blob/main/src/features/transactions/components/AddTransactionModal.jsx"
click node_txlist "https://github.com/j12steve/chitieusmart/blob/main/src/features/transactions/components/TransactionList.jsx"
click node_txitem "https://github.com/j12steve/chitieusmart/blob/main/src/features/transactions/components/TransactionItem.jsx"
click node_addbutton "https://github.com/j12steve/chitieusmart/blob/main/src/features/transactions/components/AddTransactionButton.jsx"
click node_dashboard "https://github.com/j12steve/chitieusmart/blob/main/src/features/dashboard/DashboardPage.jsx"
click node_stats "https://github.com/j12steve/chitieusmart/blob/main/src/features/dashboard/hooks/useDashboardStats.js"
click node_balance "https://github.com/j12steve/chitieusmart/blob/main/src/features/dashboard/components/BalanceCard.jsx"
click node_summary "https://github.com/j12steve/chitieusmart/blob/main/src/features/dashboard/components/SummaryStats.jsx"
click node_chart "https://github.com/j12steve/chitieusmart/blob/main/src/features/dashboard/components/CashflowChart.jsx"
click node_budgetpage "https://github.com/j12steve/chitieusmart/blob/main/src/features/budgets/BudgetsPage.jsx"
click node_budgethook "https://github.com/j12steve/chitieusmart/blob/main/src/features/budgets/hooks/useBudgets.js"
click node_budgetcard "https://github.com/j12steve/chitieusmart/blob/main/src/features/budgets/components/BudgetCard.jsx"
click node_calculations "https://github.com/j12steve/chitieusmart/blob/main/src/utils/calculations.js"
click node_categories "https://github.com/j12steve/chitieusmart/blob/main/src/constants/categories.js"
click node_seed "https://github.com/j12steve/chitieusmart/blob/main/src/data/seed.js"
click node_storage "https://github.com/j12steve/chitieusmart/blob/main/src/hooks/useLocalStorage.js"
click node_date "https://github.com/j12steve/chitieusmart/blob/main/src/utils/formatDate.js"
click node_currency "https://github.com/j12steve/chitieusmart/blob/main/src/utils/formatCurrency.js"
click node_ui "https://github.com/j12steve/chitieusmart/blob/main/src/components/ui/index.js"
click node_header "https://github.com/j12steve/chitieusmart/blob/main/src/components/layout/PageHeader.jsx"
click node_motion "https://github.com/j12steve/chitieusmart/blob/main/src/utils/motion.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_shell,node_nav,node_user toneBlue
class node_provider,node_txhook,node_txpage,node_txform,node_addmodal,node_txlist,node_txitem,node_addbutton toneAmber
class node_dashboard,node_stats,node_balance,node_summary,node_chart,node_budgetpage,node_budgethook,node_budgetcard toneMint
class node_calculations,node_categories,node_seed,node_storage,node_date,node_currency,node_ui,node_header,node_motion toneRose
```

## Components

### Application shell

- [App routing](https://github.com/j12steve/chitieusmart/blob/main/src/App.jsx): `src/App.jsx`
- [App shell](https://github.com/j12steve/chitieusmart/blob/main/src/components/layout/AppShell.jsx): `src/components/layout/AppShell.jsx`
- [Navigation](https://github.com/j12steve/chitieusmart/blob/main/src/components/layout/Navigation.jsx): `src/components/layout/Navigation.jsx`

### Transaction tracking

- [Transaction state](https://github.com/j12steve/chitieusmart/blob/main/src/features/transactions/TransactionsProvider.jsx): `src/features/transactions/TransactionsProvider.jsx`
- [Transaction access](https://github.com/j12steve/chitieusmart/blob/main/src/features/transactions/hooks/useTransactions.js): `src/features/transactions/hooks/useTransactions.js`
- [Transactions page](https://github.com/j12steve/chitieusmart/blob/main/src/features/transactions/TransactionsPage.jsx): `src/features/transactions/TransactionsPage.jsx`
- [Transaction form](https://github.com/j12steve/chitieusmart/blob/main/src/features/transactions/components/TransactionForm.jsx): `src/features/transactions/components/TransactionForm.jsx`
- [Add transaction modal](https://github.com/j12steve/chitieusmart/blob/main/src/features/transactions/components/AddTransactionModal.jsx): `src/features/transactions/components/AddTransactionModal.jsx`
- [Transaction list](https://github.com/j12steve/chitieusmart/blob/main/src/features/transactions/components/TransactionList.jsx): `src/features/transactions/components/TransactionList.jsx`
- [Transaction item](https://github.com/j12steve/chitieusmart/blob/main/src/features/transactions/components/TransactionItem.jsx): `src/features/transactions/components/TransactionItem.jsx`
- [Add button](https://github.com/j12steve/chitieusmart/blob/main/src/features/transactions/components/AddTransactionButton.jsx): `src/features/transactions/components/AddTransactionButton.jsx`

### Finance insights

- [Dashboard page](https://github.com/j12steve/chitieusmart/blob/main/src/features/dashboard/DashboardPage.jsx): `src/features/dashboard/DashboardPage.jsx`
- [Dashboard stats](https://github.com/j12steve/chitieusmart/blob/main/src/features/dashboard/hooks/useDashboardStats.js): `src/features/dashboard/hooks/useDashboardStats.js`
- [Balance card](https://github.com/j12steve/chitieusmart/blob/main/src/features/dashboard/components/BalanceCard.jsx): `src/features/dashboard/components/BalanceCard.jsx`
- [Summary stats](https://github.com/j12steve/chitieusmart/blob/main/src/features/dashboard/components/SummaryStats.jsx): `src/features/dashboard/components/SummaryStats.jsx`
- [Cashflow chart](https://github.com/j12steve/chitieusmart/blob/main/src/features/dashboard/components/CashflowChart.jsx): `src/features/dashboard/components/CashflowChart.jsx`
- [Budgets page](https://github.com/j12steve/chitieusmart/blob/main/src/features/budgets/BudgetsPage.jsx): `src/features/budgets/BudgetsPage.jsx`
- [Budget calculations](https://github.com/j12steve/chitieusmart/blob/main/src/features/budgets/hooks/useBudgets.js): `src/features/budgets/hooks/useBudgets.js`
- [Budget card](https://github.com/j12steve/chitieusmart/blob/main/src/features/budgets/components/BudgetCard.jsx): `src/features/budgets/components/BudgetCard.jsx`

### Shared data and UI

- [Finance calculations](https://github.com/j12steve/chitieusmart/blob/main/src/utils/calculations.js): `src/utils/calculations.js`
- [Categories](https://github.com/j12steve/chitieusmart/blob/main/src/constants/categories.js): `src/constants/categories.js`
- [Seed data](https://github.com/j12steve/chitieusmart/blob/main/src/data/seed.js): `src/data/seed.js`
- [Browser storage](https://github.com/j12steve/chitieusmart/blob/main/src/hooks/useLocalStorage.js): `src/hooks/useLocalStorage.js`
- [Date utilities](https://github.com/j12steve/chitieusmart/blob/main/src/utils/formatDate.js): `src/utils/formatDate.js`
- [Currency formatting](https://github.com/j12steve/chitieusmart/blob/main/src/utils/formatCurrency.js): `src/utils/formatCurrency.js`
- [Shared UI components](https://github.com/j12steve/chitieusmart/blob/main/src/components/ui/index.js): `src/components/ui/index.js`
- [Page header](https://github.com/j12steve/chitieusmart/blob/main/src/components/layout/PageHeader.jsx): `src/components/layout/PageHeader.jsx`
- [Motion presets](https://github.com/j12steve/chitieusmart/blob/main/src/utils/motion.js): `src/utils/motion.js`

### Other components

- **User**

## Connections

- User → App routing: uses
- App routing → Transaction state: provides state (evidence: `src/App.jsx`)
- App routing → App shell: renders (evidence: `src/App.jsx`)
- App routing → Dashboard page: renders (evidence: `src/App.jsx`)
- App routing → Transactions page: renders (evidence: `src/App.jsx`)
- App routing → Budgets page: renders (evidence: `src/App.jsx`)
- App routing → Add transaction modal: renders (evidence: `src/App.jsx`)
- App shell → Navigation: renders (evidence: `src/components/layout/AppShell.jsx`)
- Transaction state → Browser storage: persists state (evidence: `src/features/transactions/TransactionsProvider.jsx`)
- Transaction state → Seed data: loads defaults (evidence: `src/features/transactions/TransactionsProvider.jsx`)
- Transaction state → Finance calculations: uses (evidence: `src/features/transactions/TransactionsProvider.jsx`)
- Transaction state → Transaction access: provides context (evidence: `src/features/transactions/TransactionsProvider.jsx`)
- Transactions page → Transaction access: reads state (evidence: `src/features/transactions/TransactionsPage.jsx`)
- Transactions page → Add button: renders (evidence: `src/features/transactions/TransactionsPage.jsx`)
- Transactions page → Transaction list: renders (evidence: `src/features/transactions/TransactionsPage.jsx`)
- Add transaction modal → Transaction access: uses (evidence: `src/features/transactions/components/AddTransactionModal.jsx`)
- Add transaction modal → Transaction form: renders (evidence: `src/features/transactions/components/AddTransactionModal.jsx`)
- Transaction list → Transaction item: renders (evidence: `src/features/transactions/components/TransactionList.jsx`)
- Dashboard page → Transaction access: reads state (evidence: `src/features/dashboard/DashboardPage.jsx`)
- Dashboard page → Dashboard stats: calculates (evidence: `src/features/dashboard/DashboardPage.jsx`)
- Dashboard page → Transaction list: renders (evidence: `src/features/dashboard/DashboardPage.jsx`)
- Dashboard page → Add button: renders (evidence: `src/features/dashboard/DashboardPage.jsx`)
- Dashboard page → Balance card: renders (evidence: `src/features/dashboard/DashboardPage.jsx`)
- Dashboard page → Summary stats: renders (evidence: `src/features/dashboard/DashboardPage.jsx`)
- Dashboard page → Cashflow chart: renders (evidence: `src/features/dashboard/DashboardPage.jsx`)
- Dashboard stats → Finance calculations: uses (evidence: `src/features/dashboard/hooks/useDashboardStats.js`)
- Budgets page → Transaction access: reads state (evidence: `src/features/budgets/BudgetsPage.jsx`)
- Budgets page → Budget calculations: calculates (evidence: `src/features/budgets/BudgetsPage.jsx`)
- Budgets page → Budget card: renders (evidence: `src/features/budgets/BudgetsPage.jsx`)
- Budget calculations → Browser storage: persists limits (evidence: `src/features/budgets/hooks/useBudgets.js`)
- Budget calculations → Seed data: loads defaults (evidence: `src/features/budgets/hooks/useBudgets.js`)
- Budget calculations → Finance calculations: aggregates spending (evidence: `src/features/budgets/hooks/useBudgets.js`)
- Finance calculations → Date utilities: uses (evidence: `src/utils/calculations.js`)
- Transaction form → Categories: uses (evidence: `src/features/transactions/components/TransactionForm.jsx`)
- Transaction item → Categories: uses (evidence: `src/features/transactions/components/TransactionItem.jsx`)
- Transaction item → Currency formatting: formats amounts (evidence: `src/features/transactions/components/TransactionItem.jsx`)
- Transaction item → Date utilities: formats dates (evidence: `src/features/transactions/components/TransactionItem.jsx`)
- Budget card → Categories: uses (evidence: `src/features/budgets/components/BudgetCard.jsx`)
- Budget card → Currency formatting: formats amounts (evidence: `src/features/budgets/components/BudgetCard.jsx`)
- Dashboard page → Page header: renders (evidence: `src/features/dashboard/DashboardPage.jsx`)
- Budgets page → Page header: renders (evidence: `src/features/budgets/BudgetsPage.jsx`)
- Dashboard page → Shared UI components: uses (evidence: `src/features/dashboard/DashboardPage.jsx`)
