# priya-0110/pocketledger architecture

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

- Interactive diagram: https://gitdiagram.com/priya-0110/pocketledger
- Repository: https://github.com/priya-0110/pocketledger

## Overview

PocketLedger is a personal-finance web application for tracking transactions, budgets, accounts, and spending. Users enter through routed login or signup screens; protected areas provide transaction and budget management, account settings, dashboard summaries, and reports. The sampled client code shows dashboard and reporting views fetching transaction data, and budget views fetching budget data from the server. The server implementation was listed as read but not excerpted, so its internal responsibilities and other client-server connections are not detailed here.

Main entry points: [`client/src/App.jsx`](https://github.com/priya-0110/pocketledger/blob/main/client/src/App.jsx) (Application routes), [`client/src/pages/Dashboard.jsx`](https://github.com/priya-0110/pocketledger/blob/main/client/src/pages/Dashboard.jsx) (Dashboard), [`server/server.js`](https://github.com/priya-0110/pocketledger/blob/main/server/server.js) (API server), [`client/src/pages/Reports.jsx`](https://github.com/priya-0110/pocketledger/blob/main/client/src/pages/Reports.jsx) (Reports)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["App navigation"]
  node_app["Application routes<br/>[App.jsx]"]
  node_layout["Page layout<br/>[Layout.jsx]"]
  node_navbar["Navbar<br/>[Navbar.jsx]"]
  node_sidebar["Sidebar<br/>[Sidebar.jsx]"]
  node_guard["Protected routes<br/>[ProtectedRoute.jsx]"]
end

subgraph group_finance["Finance management"]
  node_transactions["Transactions<br/>[Transactions.jsx]"]
  node_transaction_form["Transaction form"]
  node_budgets["Budget management<br/>[Budgets.jsx]"]
  node_accounts["Accounts<br/>[Accounts.jsx]"]
end

subgraph group_insights["Financial insights"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_budget_overview["Budget overview"]
  node_reports["Reports<br/>[Reports.jsx]"]
  node_summary["Summary cards<br/>[SummaryCard.jsx]"]
  node_spending["Spending chart"]
end

subgraph group_identity["Identity and account"]
  node_login["Login<br/>[Login.jsx]"]
  node_signup["Sign up<br/>[SignUp.jsx]"]
  node_settings["Settings<br/>[Settings.jsx]"]
end

node_server["API server<br/>[server.js]"]

node_app -->|"renders layout"| node_layout
node_app -->|"guards routes"| node_guard
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_transactions
node_app -->|"routes to"| node_budgets
node_app -->|"routes to"| node_accounts
node_app -->|"routes to"| node_reports
node_app -->|"routes to"| node_settings
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_signup
node_layout -->|"renders"| node_navbar
node_layout -->|"renders"| node_sidebar
node_transactions -->|"opens form"| node_transaction_form
node_dashboard -->|"fetches transactions"| node_server
node_dashboard -->|"renders"| node_summary
node_dashboard -->|"renders"| node_spending
node_dashboard -->|"renders"| node_budget_overview
node_budget_overview -->|"fetches budgets"| node_server
node_budgets -->|"manages budgets"| node_server
node_accounts -->|"updates profile"| node_server
node_reports -->|"fetches transactions"| node_server
node_reports -->|"renders"| node_summary
node_reports -->|"renders"| node_spending

click node_app "https://github.com/priya-0110/pocketledger/blob/main/client/src/App.jsx"
click node_layout "https://github.com/priya-0110/pocketledger/blob/main/client/src/components/Layout.jsx"
click node_navbar "https://github.com/priya-0110/pocketledger/blob/main/client/src/components/Navbar.jsx"
click node_sidebar "https://github.com/priya-0110/pocketledger/blob/main/client/src/components/Sidebar.jsx"
click node_guard "https://github.com/priya-0110/pocketledger/blob/main/client/src/components/ProtectedRoute.jsx"
click node_transactions "https://github.com/priya-0110/pocketledger/blob/main/client/src/pages/Transactions.jsx"
click node_transaction_form "https://github.com/priya-0110/pocketledger/blob/main/client/src/components/AddTransactions.jsx"
click node_budgets "https://github.com/priya-0110/pocketledger/blob/main/client/src/pages/Budgets.jsx"
click node_accounts "https://github.com/priya-0110/pocketledger/blob/main/client/src/pages/Accounts.jsx"
click node_dashboard "https://github.com/priya-0110/pocketledger/blob/main/client/src/pages/Dashboard.jsx"
click node_budget_overview "https://github.com/priya-0110/pocketledger/blob/main/client/src/components/BudgetsOverview.jsx"
click node_reports "https://github.com/priya-0110/pocketledger/blob/main/client/src/pages/Reports.jsx"
click node_summary "https://github.com/priya-0110/pocketledger/blob/main/client/src/components/SummaryCard.jsx"
click node_spending "https://github.com/priya-0110/pocketledger/blob/main/client/src/components/SpendingOverview.jsx"
click node_login "https://github.com/priya-0110/pocketledger/blob/main/client/src/pages/Login.jsx"
click node_signup "https://github.com/priya-0110/pocketledger/blob/main/client/src/components/SignUp.jsx"
click node_settings "https://github.com/priya-0110/pocketledger/blob/main/client/src/pages/Settings.jsx"
click node_server "https://github.com/priya-0110/pocketledger/blob/main/server/server.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_layout,node_navbar,node_sidebar,node_guard toneBlue
class node_transactions,node_transaction_form,node_budgets,node_accounts toneAmber
class node_dashboard,node_budget_overview,node_reports,node_summary,node_spending,node_server toneMint
class node_login,node_signup,node_settings toneRose
```

## Components

### App navigation

- [Application routes](https://github.com/priya-0110/pocketledger/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Page layout](https://github.com/priya-0110/pocketledger/blob/main/client/src/components/Layout.jsx): `client/src/components/Layout.jsx`
- [Navbar](https://github.com/priya-0110/pocketledger/blob/main/client/src/components/Navbar.jsx): `client/src/components/Navbar.jsx`
- [Sidebar](https://github.com/priya-0110/pocketledger/blob/main/client/src/components/Sidebar.jsx): `client/src/components/Sidebar.jsx`
- [Protected routes](https://github.com/priya-0110/pocketledger/blob/main/client/src/components/ProtectedRoute.jsx): `client/src/components/ProtectedRoute.jsx`

### Finance management

- [Transactions](https://github.com/priya-0110/pocketledger/blob/main/client/src/pages/Transactions.jsx): `client/src/pages/Transactions.jsx`
- [Transaction form](https://github.com/priya-0110/pocketledger/blob/main/client/src/components/AddTransactions.jsx): `client/src/components/AddTransactions.jsx`
- [Budget management](https://github.com/priya-0110/pocketledger/blob/main/client/src/pages/Budgets.jsx): `client/src/pages/Budgets.jsx`
- [Accounts](https://github.com/priya-0110/pocketledger/blob/main/client/src/pages/Accounts.jsx): `client/src/pages/Accounts.jsx`

### Financial insights

- [Dashboard](https://github.com/priya-0110/pocketledger/blob/main/client/src/pages/Dashboard.jsx): `client/src/pages/Dashboard.jsx`
- [Budget overview](https://github.com/priya-0110/pocketledger/blob/main/client/src/components/BudgetsOverview.jsx): `client/src/components/BudgetsOverview.jsx`
- [Reports](https://github.com/priya-0110/pocketledger/blob/main/client/src/pages/Reports.jsx): `client/src/pages/Reports.jsx`
- [Summary cards](https://github.com/priya-0110/pocketledger/blob/main/client/src/components/SummaryCard.jsx): `client/src/components/SummaryCard.jsx`
- [Spending chart](https://github.com/priya-0110/pocketledger/blob/main/client/src/components/SpendingOverview.jsx): `client/src/components/SpendingOverview.jsx`

### Identity and account

- [Login](https://github.com/priya-0110/pocketledger/blob/main/client/src/pages/Login.jsx): `client/src/pages/Login.jsx`
- [Sign up](https://github.com/priya-0110/pocketledger/blob/main/client/src/components/SignUp.jsx): `client/src/components/SignUp.jsx`
- [Settings](https://github.com/priya-0110/pocketledger/blob/main/client/src/pages/Settings.jsx): `client/src/pages/Settings.jsx`

### Other components

- [API server](https://github.com/priya-0110/pocketledger/blob/main/server/server.js): `server/server.js`

## Connections

- Application routes → Page layout: renders layout (evidence: `client/src/App.jsx`)
- Application routes → Protected routes: guards routes (evidence: `client/src/App.jsx`)
- Application routes → Dashboard: routes to (evidence: `client/src/App.jsx`)
- Application routes → Transactions: routes to (evidence: `client/src/App.jsx`)
- Application routes → Budget management: routes to (evidence: `client/src/App.jsx`)
- Application routes → Accounts: routes to (evidence: `client/src/App.jsx`)
- Application routes → Reports: routes to (evidence: `client/src/App.jsx`)
- Application routes → Settings: routes to (evidence: `client/src/App.jsx`)
- Application routes → Login: routes to (evidence: `client/src/App.jsx`)
- Application routes → Sign up: routes to (evidence: `client/src/App.jsx`)
- Page layout → Navbar: renders (evidence: `client/src/components/Layout.jsx`)
- Page layout → Sidebar: renders (evidence: `client/src/components/Layout.jsx`)
- Transactions → Transaction form: opens form (evidence: `client/src/pages/Transactions.jsx`)
- Dashboard → API server: fetches transactions (evidence: `client/src/pages/Dashboard.jsx`)
- Dashboard → Summary cards: renders (evidence: `client/src/pages/Dashboard.jsx`)
- Dashboard → Spending chart: renders (evidence: `client/src/pages/Dashboard.jsx`)
- Dashboard → Budget overview: renders (evidence: `client/src/pages/Dashboard.jsx`)
- Budget overview → API server: fetches budgets (evidence: `client/src/components/BudgetsOverview.jsx`)
- Budget management → API server: manages budgets (evidence: `client/src/pages/Budgets.jsx`)
- Accounts → API server: updates profile (evidence: `client/src/pages/Accounts.jsx`)
- Reports → API server: fetches transactions (evidence: `client/src/pages/Reports.jsx`)
- Reports → Summary cards: renders (evidence: `client/src/pages/Reports.jsx`)
- Reports → Spending chart: renders (evidence: `client/src/pages/Reports.jsx`)
