# girishelankonda/personal-expense-tracker architecture

> Architecture diagram of the GitHub repository girishelankonda/personal-expense-tracker, 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/girishelankonda/personal-expense-tracker
- Repository: https://github.com/girishelankonda/personal-expense-tracker

## Overview

Personal Expense Tracker is a React frontend backed by an Express REST API and MongoDB. Users register or log in, then manage income and expenses; the dashboard presents totals, recent activity, category breakdowns, and monthly/weekly charts. The frontend routes users to authentication, dashboard, transaction-list, and transaction-form pages; authenticated API requests reach protected backend routes, whose controllers read and write transaction records. The graph preserves documented features, but unsampled database configuration and some UI details limit implementation-level links.

Main entry points: [`frontend/src/App.jsx`](https://github.com/girishelankonda/personal-expense-tracker/blob/main/frontend/src/App.jsx) (Routes and access), [`frontend/src/services/api.js`](https://github.com/girishelankonda/personal-expense-tracker/blob/main/frontend/src/services/api.js) (HTTP client), [`backend/server.js`](https://github.com/girishelankonda/personal-expense-tracker/blob/main/backend/server.js) (API server), [`frontend/src/pages/AuthPage.jsx`](https://github.com/girishelankonda/personal-expense-tracker/blob/main/frontend/src/pages/AuthPage.jsx) (Login and register)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["React application"]
  node_app["Routes and access<br/>[App.jsx]"]
  node_authpage["Login and register<br/>[AuthPage.jsx]"]
  node_sidebar["Navigation<br/>[Sidebar.jsx]"]
  node_dashboard["Dashboard summaries<br/>[DashboardPage.jsx]"]
  node_statcard["Summary cards<br/>[StatCard.jsx]"]
  node_api["HTTP client<br/>[api.js]"]
end

subgraph group_backend["Express API"]
  node_webserver["API server<br/>[server.js]"]
  node_dbconfig["Database connection<br/>[db.js]"]
end

subgraph group_identity["Authentication"]
  node_authstate["Session state<br/>[AuthContext.jsx]"]
  node_logout["Logout action<br/>[LogoutButton.jsx]"]
  node_authroutes["Auth routes<br/>[authRoutes.js]"]
  node_authcontroller["Account operations<br/>[authController.js]"]
  node_authmiddleware["JWT protection<br/>[authMiddleware.js]"]
  node_usermodel[("User records<br/>[User.js]")]
end

subgraph group_records["Transaction data"]
  node_transactions["Transaction list"]
  node_transactionform["Transaction editor"]
  node_transactionroutes["Transaction routes"]
  node_transactioncontroller["Transaction operations"]
  node_transactionmodel[("Transaction records<br/>[Transaction.js]")]
end

node_person(("Tracker user"))
node_mongodb[("MongoDB")]

node_person -->|"uses"| node_app
node_app -->|"routes to"| node_authpage
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_transactions
node_app -->|"routes to"| node_transactionform
node_app -->|"renders"| node_sidebar
node_authpage -->|"submits credentials"| node_api
node_authpage -->|"sets session"| node_authstate
node_sidebar -->|"renders"| node_logout
node_logout -->|"clears session"| node_authstate
node_dashboard -->|"requests summaries"| node_api
node_dashboard -->|"renders"| node_statcard
node_transactions -->|"requests records"| node_api
node_transactionform -->|"saves records"| node_api
node_api -->|"calls REST API"| node_webserver
node_webserver -->|"connects database"| node_dbconfig
node_webserver -->|"mounts routes"| node_authroutes
node_webserver -->|"mounts routes"| node_transactionroutes
node_authroutes -->|"dispatches requests"| node_authcontroller
node_transactionroutes -->|"protects routes"| node_authmiddleware
node_transactionroutes -->|"dispatches requests"| node_transactioncontroller
node_authcontroller -->|"reads and writes"| node_usermodel
node_transactioncontroller -->|"reads and writes"| node_transactionmodel
node_dbconfig -.->|"connects"| node_mongodb

click node_app "https://github.com/girishelankonda/personal-expense-tracker/blob/main/frontend/src/App.jsx"
click node_authpage "https://github.com/girishelankonda/personal-expense-tracker/blob/main/frontend/src/pages/AuthPage.jsx"
click node_authstate "https://github.com/girishelankonda/personal-expense-tracker/blob/main/frontend/src/context/AuthContext.jsx"
click node_sidebar "https://github.com/girishelankonda/personal-expense-tracker/blob/main/frontend/src/components/Sidebar.jsx"
click node_logout "https://github.com/girishelankonda/personal-expense-tracker/blob/main/frontend/src/components/LogoutButton.jsx"
click node_dashboard "https://github.com/girishelankonda/personal-expense-tracker/blob/main/frontend/src/pages/DashboardPage.jsx"
click node_statcard "https://github.com/girishelankonda/personal-expense-tracker/blob/main/frontend/src/components/StatCard.jsx"
click node_transactions "https://github.com/girishelankonda/personal-expense-tracker/blob/main/frontend/src/pages/TransactionsPage.jsx"
click node_transactionform "https://github.com/girishelankonda/personal-expense-tracker/blob/main/frontend/src/pages/TransactionFormPage.jsx"
click node_api "https://github.com/girishelankonda/personal-expense-tracker/blob/main/frontend/src/services/api.js"
click node_webserver "https://github.com/girishelankonda/personal-expense-tracker/blob/main/backend/server.js"
click node_authroutes "https://github.com/girishelankonda/personal-expense-tracker/blob/main/backend/routes/authRoutes.js"
click node_authcontroller "https://github.com/girishelankonda/personal-expense-tracker/blob/main/backend/controllers/authController.js"
click node_authmiddleware "https://github.com/girishelankonda/personal-expense-tracker/blob/main/backend/middleware/authMiddleware.js"
click node_transactionroutes "https://github.com/girishelankonda/personal-expense-tracker/blob/main/backend/routes/transactionRoutes.js"
click node_transactioncontroller "https://github.com/girishelankonda/personal-expense-tracker/blob/main/backend/controllers/transactionController.js"
click node_usermodel "https://github.com/girishelankonda/personal-expense-tracker/blob/main/backend/models/User.js"
click node_transactionmodel "https://github.com/girishelankonda/personal-expense-tracker/blob/main/backend/models/Transaction.js"
click node_dbconfig "https://github.com/girishelankonda/personal-expense-tracker/blob/main/backend/config/db.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_authpage,node_sidebar,node_dashboard,node_statcard,node_api,node_person toneBlue
class node_webserver,node_dbconfig,node_mongodb toneAmber
class node_authstate,node_logout,node_authroutes,node_authcontroller,node_authmiddleware,node_usermodel toneMint
class node_transactions,node_transactionform,node_transactionroutes,node_transactioncontroller,node_transactionmodel toneRose
```

## Components

### React application

- [Routes and access](https://github.com/girishelankonda/personal-expense-tracker/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Login and register](https://github.com/girishelankonda/personal-expense-tracker/blob/main/frontend/src/pages/AuthPage.jsx): `frontend/src/pages/AuthPage.jsx`
- [Navigation](https://github.com/girishelankonda/personal-expense-tracker/blob/main/frontend/src/components/Sidebar.jsx): `frontend/src/components/Sidebar.jsx`
- [Dashboard summaries](https://github.com/girishelankonda/personal-expense-tracker/blob/main/frontend/src/pages/DashboardPage.jsx): `frontend/src/pages/DashboardPage.jsx`
- [Summary cards](https://github.com/girishelankonda/personal-expense-tracker/blob/main/frontend/src/components/StatCard.jsx): `frontend/src/components/StatCard.jsx`
- [HTTP client](https://github.com/girishelankonda/personal-expense-tracker/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### Express API

- [API server](https://github.com/girishelankonda/personal-expense-tracker/blob/main/backend/server.js): `backend/server.js`
- [Database connection](https://github.com/girishelankonda/personal-expense-tracker/blob/main/backend/config/db.js): `backend/config/db.js`

### Authentication

- [Session state](https://github.com/girishelankonda/personal-expense-tracker/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Logout action](https://github.com/girishelankonda/personal-expense-tracker/blob/main/frontend/src/components/LogoutButton.jsx): `frontend/src/components/LogoutButton.jsx`
- [Auth routes](https://github.com/girishelankonda/personal-expense-tracker/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [Account operations](https://github.com/girishelankonda/personal-expense-tracker/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [JWT protection](https://github.com/girishelankonda/personal-expense-tracker/blob/main/backend/middleware/authMiddleware.js): `backend/middleware/authMiddleware.js`
- [User records](https://github.com/girishelankonda/personal-expense-tracker/blob/main/backend/models/User.js): `backend/models/User.js`

### Transaction data

- [Transaction list](https://github.com/girishelankonda/personal-expense-tracker/blob/main/frontend/src/pages/TransactionsPage.jsx): `frontend/src/pages/TransactionsPage.jsx`
- [Transaction editor](https://github.com/girishelankonda/personal-expense-tracker/blob/main/frontend/src/pages/TransactionFormPage.jsx): `frontend/src/pages/TransactionFormPage.jsx`
- [Transaction routes](https://github.com/girishelankonda/personal-expense-tracker/blob/main/backend/routes/transactionRoutes.js): `backend/routes/transactionRoutes.js`
- [Transaction operations](https://github.com/girishelankonda/personal-expense-tracker/blob/main/backend/controllers/transactionController.js): `backend/controllers/transactionController.js`
- [Transaction records](https://github.com/girishelankonda/personal-expense-tracker/blob/main/backend/models/Transaction.js): `backend/models/Transaction.js`

### Other components

- **Tracker user**
- **MongoDB**

## Connections

- Tracker user → Routes and access: uses (evidence: `README.md`)
- Routes and access → Login and register: routes to (evidence: `frontend/src/App.jsx`)
- Routes and access → Dashboard summaries: routes to (evidence: `frontend/src/App.jsx`)
- Routes and access → Transaction list: routes to (evidence: `frontend/src/App.jsx`)
- Routes and access → Transaction editor: routes to (evidence: `frontend/src/App.jsx`)
- Routes and access → Navigation: renders (evidence: `frontend/src/App.jsx`)
- Login and register → HTTP client: submits credentials (evidence: `frontend/src/pages/AuthPage.jsx`)
- Login and register → Session state: sets session (evidence: `frontend/src/pages/AuthPage.jsx`)
- Navigation → Logout action: renders (evidence: `frontend/src/components/Sidebar.jsx`)
- Logout action → Session state: clears session (evidence: `frontend/src/components/LogoutButton.jsx`)
- Dashboard summaries → HTTP client: requests summaries (evidence: `frontend/src/pages/DashboardPage.jsx`)
- Dashboard summaries → Summary cards: renders (evidence: `frontend/src/pages/DashboardPage.jsx`)
- Transaction list → HTTP client: requests records (evidence: `frontend/src/pages/TransactionsPage.jsx`)
- Transaction editor → HTTP client: saves records (evidence: `frontend/src/pages/TransactionFormPage.jsx`)
- HTTP client → API server: calls REST API (evidence: `README.md`)
- API server → Database connection: connects database (evidence: `backend/server.js`)
- API server → Auth routes: mounts routes (evidence: `backend/server.js`)
- API server → Transaction routes: mounts routes (evidence: `backend/server.js`)
- Auth routes → Account operations: dispatches requests (evidence: `backend/routes/authRoutes.js`)
- Transaction routes → JWT protection: protects routes (evidence: `backend/routes/transactionRoutes.js`)
- Transaction routes → Transaction operations: dispatches requests (evidence: `backend/routes/transactionRoutes.js`)
- Account operations → User records: reads and writes (evidence: `backend/controllers/authController.js`)
- Transaction operations → Transaction records: reads and writes (evidence: `backend/controllers/transactionController.js`)
- Database connection → MongoDB: connects (evidence: `README.md`)
