# aadil-4u/savify architecture

> Architecture diagram of the GitHub repository aadil-4u/savify, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aadil-4u/savify
- Repository: https://github.com/aadil-4u/savify

## Overview

Savify is a personal-finance web app. Users register or sign in, then manage transactions and categories, review dashboard summaries and budgets, and configure account, currency, and theme preferences. The React pages call a centralized Axios client; the Express API routes requests to controllers, which operate on MongoDB models or exchange-rate and email services. The README documents additional capabilities such as CSV export, OTP recovery, and atomic account deletion. Some frontend-to-API and unsampled route details are documented or implied rather than visible in excerpts, so those links are marked unverified.

Main entry points: [`frontend/src/App.jsx`](https://github.com/aadil-4u/savify/blob/main/frontend/src/App.jsx) (App routing), [`frontend/src/services/api.js`](https://github.com/aadil-4u/savify/blob/main/frontend/src/services/api.js) (HTTP client), [`backend/controllers/authController.js`](https://github.com/aadil-4u/savify/blob/main/backend/controllers/authController.js) (Account workflows), [`backend/server.js`](https://github.com/aadil-4u/savify/blob/main/backend/server.js) (Express API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["App routing<br/>[App.jsx]"]
  node_authui["Auth screens<br/>[Login.jsx]"]
  node_financeui["Finance screens<br/>[Dashboard.jsx]"]
  node_categoriesui["Category screens<br/>[Categories.jsx]"]
  node_transactionsui["Transaction screens<br/>[Transactions.jsx]"]
  node_settingsui["Settings screen<br/>[Settings.jsx]"]
  node_authstate["Auth context<br/>[AuthContext.jsx]"]
  node_theme["Theme context<br/>[ThemeContext.jsx]"]
  node_api["HTTP client<br/>[api.js]"]
end

subgraph group_identity["Identity and security"]
  node_authroutes["Auth routes<br/>[authRoutes.js]"]
  node_authguard["JWT protection<br/>[authMiddleware.js]"]
  node_authlogic["Account workflows<br/>[authController.js]"]
  node_email["Email delivery<br/>[emailService.js]"]
end

subgraph group_finance["Finance services"]
  node_transactionroutes["Transaction routes"]
  node_transactionlogic["Transactions and analytics"]
  node_categorylogic["Categories and budgets"]
  node_currencyroutes["Currency routes<br/>[currencyRoutes.js]"]
  node_currencylogic["Currency rates"]
end

subgraph group_platform["API and persistence"]
  node_backend["Express API<br/>[server.js]"]
  node_userstore[("User records<br/>[User.js]")]
  node_transactionstore[("Transaction records<br/>[Transaction.js]")]
  node_categorystore[("Category records<br/>[Category.js]")]
end

node_person(("User"))
node_mongo[("MongoDB")]
node_rateservice["Exchange-rate API"]

node_person -->|"uses"| node_app
node_app -->|"routes to"| node_authui
node_app -->|"routes to"| node_financeui
node_app -->|"routes to"| node_categoriesui
node_app -->|"routes to"| node_transactionsui
node_app -->|"routes to"| node_settingsui
node_app -->|"provides"| node_authstate
node_app -->|"provides"| node_theme
node_authui -->|"uses"| node_authstate
node_authstate -->|"sends requests"| node_api
node_financeui -->|"sends requests"| node_api
node_categoriesui -->|"sends requests"| node_api
node_transactionsui -->|"sends requests"| node_api
node_settingsui -->|"sends requests"| node_api
node_api -.->|"calls REST API"| node_backend
node_backend -->|"connects"| node_mongo
node_backend -->|"mounts routes"| node_authroutes
node_backend -->|"mounts routes"| node_transactionroutes
node_backend -->|"mounts routes"| node_currencyroutes
node_authroutes -->|"dispatches to"| node_authlogic
node_authroutes -->|"protects routes"| node_authguard
node_authlogic -->|"reads and writes"| node_userstore
node_authlogic -->|"deletes records"| node_transactionstore
node_authlogic -->|"deletes records"| node_categorystore
node_authlogic -->|"sends email"| node_email
node_transactionroutes -->|"dispatches to"| node_transactionlogic
node_transactionroutes -->|"protects routes"| node_authguard
node_transactionlogic -->|"reads and writes"| node_transactionstore
node_transactionlogic -->|"reads and writes"| node_categorystore
node_transactionlogic -->|"gets rates"| node_currencylogic
node_categorylogic -->|"queries spending"| node_transactionstore
node_categorylogic -->|"reads and writes"| node_categorystore
node_categorylogic -->|"gets rates"| node_currencylogic
node_currencyroutes -.->|"dispatches to"| node_currencylogic
node_currencylogic -->|"fetches rates"| node_rateservice
node_userstore -.->|"persists in"| node_mongo
node_transactionstore -.->|"persists in"| node_mongo
node_categorystore -.->|"persists in"| node_mongo

click node_app "https://github.com/aadil-4u/savify/blob/main/frontend/src/App.jsx"
click node_authui "https://github.com/aadil-4u/savify/blob/main/frontend/src/pages/Login.jsx"
click node_financeui "https://github.com/aadil-4u/savify/blob/main/frontend/src/pages/Dashboard.jsx"
click node_categoriesui "https://github.com/aadil-4u/savify/blob/main/frontend/src/pages/Categories.jsx"
click node_transactionsui "https://github.com/aadil-4u/savify/blob/main/frontend/src/pages/Transactions.jsx"
click node_settingsui "https://github.com/aadil-4u/savify/blob/main/frontend/src/pages/Settings.jsx"
click node_authstate "https://github.com/aadil-4u/savify/blob/main/frontend/src/context/AuthContext.jsx"
click node_theme "https://github.com/aadil-4u/savify/blob/main/frontend/src/context/ThemeContext.jsx"
click node_api "https://github.com/aadil-4u/savify/blob/main/frontend/src/services/api.js"
click node_backend "https://github.com/aadil-4u/savify/blob/main/backend/server.js"
click node_authroutes "https://github.com/aadil-4u/savify/blob/main/backend/routes/authRoutes.js"
click node_authguard "https://github.com/aadil-4u/savify/blob/main/backend/middleware/authMiddleware.js"
click node_authlogic "https://github.com/aadil-4u/savify/blob/main/backend/controllers/authController.js"
click node_email "https://github.com/aadil-4u/savify/blob/main/backend/services/emailService.js"
click node_transactionroutes "https://github.com/aadil-4u/savify/blob/main/backend/routes/transactionRoutes.js"
click node_transactionlogic "https://github.com/aadil-4u/savify/blob/main/backend/controllers/transactionController.js"
click node_categorylogic "https://github.com/aadil-4u/savify/blob/main/backend/controllers/categoryController.js"
click node_currencyroutes "https://github.com/aadil-4u/savify/blob/main/backend/routes/currencyRoutes.js"
click node_currencylogic "https://github.com/aadil-4u/savify/blob/main/backend/services/exchangeRateService.js"
click node_userstore "https://github.com/aadil-4u/savify/blob/main/backend/models/User.js"
click node_transactionstore "https://github.com/aadil-4u/savify/blob/main/backend/models/Transaction.js"
click node_categorystore "https://github.com/aadil-4u/savify/blob/main/backend/models/Category.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_authui,node_financeui,node_categoriesui,node_transactionsui,node_settingsui,node_authstate,node_theme,node_api,node_person toneBlue
class node_authroutes,node_authguard,node_authlogic,node_email,node_mongo toneAmber
class node_transactionroutes,node_transactionlogic,node_categorylogic,node_currencyroutes,node_currencylogic,node_rateservice toneMint
class node_backend,node_userstore,node_transactionstore,node_categorystore toneRose
```

## Components

### Web application

- [App routing](https://github.com/aadil-4u/savify/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Auth screens](https://github.com/aadil-4u/savify/blob/main/frontend/src/pages/Login.jsx): `frontend/src/pages/Login.jsx`
- [Finance screens](https://github.com/aadil-4u/savify/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`
- [Category screens](https://github.com/aadil-4u/savify/blob/main/frontend/src/pages/Categories.jsx): `frontend/src/pages/Categories.jsx`
- [Transaction screens](https://github.com/aadil-4u/savify/blob/main/frontend/src/pages/Transactions.jsx): `frontend/src/pages/Transactions.jsx`
- [Settings screen](https://github.com/aadil-4u/savify/blob/main/frontend/src/pages/Settings.jsx): `frontend/src/pages/Settings.jsx`
- [Auth context](https://github.com/aadil-4u/savify/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Theme context](https://github.com/aadil-4u/savify/blob/main/frontend/src/context/ThemeContext.jsx): `frontend/src/context/ThemeContext.jsx`
- [HTTP client](https://github.com/aadil-4u/savify/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### Identity and security

- [Auth routes](https://github.com/aadil-4u/savify/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [JWT protection](https://github.com/aadil-4u/savify/blob/main/backend/middleware/authMiddleware.js): `backend/middleware/authMiddleware.js`
- [Account workflows](https://github.com/aadil-4u/savify/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [Email delivery](https://github.com/aadil-4u/savify/blob/main/backend/services/emailService.js): `backend/services/emailService.js`

### Finance services

- [Transaction routes](https://github.com/aadil-4u/savify/blob/main/backend/routes/transactionRoutes.js): `backend/routes/transactionRoutes.js`
- [Transactions and analytics](https://github.com/aadil-4u/savify/blob/main/backend/controllers/transactionController.js): `backend/controllers/transactionController.js`
- [Categories and budgets](https://github.com/aadil-4u/savify/blob/main/backend/controllers/categoryController.js): `backend/controllers/categoryController.js`
- [Currency routes](https://github.com/aadil-4u/savify/blob/main/backend/routes/currencyRoutes.js): `backend/routes/currencyRoutes.js`
- [Currency rates](https://github.com/aadil-4u/savify/blob/main/backend/services/exchangeRateService.js): `backend/services/exchangeRateService.js`

### API and persistence

- [Express API](https://github.com/aadil-4u/savify/blob/main/backend/server.js): `backend/server.js`
- [User records](https://github.com/aadil-4u/savify/blob/main/backend/models/User.js): `backend/models/User.js`
- [Transaction records](https://github.com/aadil-4u/savify/blob/main/backend/models/Transaction.js): `backend/models/Transaction.js`
- [Category records](https://github.com/aadil-4u/savify/blob/main/backend/models/Category.js): `backend/models/Category.js`

### Other components

- **User**
- **MongoDB**
- **Exchange-rate API**

## Connections

- User → App routing: uses (evidence: `frontend/src/App.jsx`)
- App routing → Auth screens: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Finance screens: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Category screens: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Transaction screens: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Settings screen: routes to (evidence: `frontend/src/App.jsx`)
- App routing → Auth context: provides (evidence: `frontend/src/App.jsx`)
- App routing → Theme context: provides (evidence: `frontend/src/App.jsx`)
- Auth screens → Auth context: uses (evidence: `frontend/src/pages/Login.jsx`)
- Auth context → HTTP client: sends requests (evidence: `frontend/src/context/AuthContext.jsx`)
- Finance screens → HTTP client: sends requests (evidence: `frontend/src/pages/Dashboard.jsx`)
- Category screens → HTTP client: sends requests (evidence: `frontend/src/pages/Categories.jsx`)
- Transaction screens → HTTP client: sends requests (evidence: `frontend/src/pages/Transactions.jsx`)
- Settings screen → HTTP client: sends requests (evidence: `frontend/src/pages/Settings.jsx`)
- HTTP client → Express API: calls REST API
- Express API → MongoDB: connects (evidence: `backend/server.js`)
- Express API → Auth routes: mounts routes (evidence: `backend/server.js`)
- Express API → Transaction routes: mounts routes (evidence: `backend/server.js`)
- Express API → Currency routes: mounts routes (evidence: `backend/server.js`)
- Auth routes → Account workflows: dispatches to (evidence: `backend/routes/authRoutes.js`)
- Auth routes → JWT protection: protects routes (evidence: `backend/routes/authRoutes.js`)
- Account workflows → User records: reads and writes (evidence: `backend/controllers/authController.js`)
- Account workflows → Transaction records: deletes records (evidence: `backend/controllers/authController.js`)
- Account workflows → Category records: deletes records (evidence: `backend/controllers/authController.js`)
- Account workflows → Email delivery: sends email (evidence: `backend/controllers/authController.js`)
- Transaction routes → Transactions and analytics: dispatches to (evidence: `backend/routes/transactionRoutes.js`)
- Transaction routes → JWT protection: protects routes (evidence: `backend/routes/transactionRoutes.js`)
- Transactions and analytics → Transaction records: reads and writes (evidence: `backend/controllers/transactionController.js`)
- Transactions and analytics → Category records: reads and writes (evidence: `backend/controllers/transactionController.js`)
- Transactions and analytics → Currency rates: gets rates (evidence: `backend/controllers/transactionController.js`)
- Categories and budgets → Transaction records: queries spending (evidence: `backend/controllers/categoryController.js`)
- Categories and budgets → Category records: reads and writes (evidence: `backend/controllers/categoryController.js`)
- Categories and budgets → Currency rates: gets rates (evidence: `backend/controllers/categoryController.js`)
- Currency routes → Currency rates: dispatches to
- Currency rates → Exchange-rate API: fetches rates (evidence: `backend/services/exchangeRateService.js`)
- User records → MongoDB: persists in
- Transaction records → MongoDB: persists in
- Category records → MongoDB: persists in
