# dudamparthiv/income-expenses-tracker-app architecture

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

- Interactive diagram: https://gitdiagram.com/dudamparthiv/income-expenses-tracker-app
- Repository: https://github.com/dudamparthiv/income-expenses-tracker-app

## Overview

This is a personal-finance tracker with a React client and Express API. The main workflow is account and transaction management: users register or log in, create accounts, record income or expenses, and review account and transaction views. The backend separates HTTP routing, authentication middleware, domain controllers, and Mongoose models for users, accounts, and transactions. The graph includes the documented client routes and API calls; several dashboard and form implementations were not sampled, so their internal connections are not inferred. Database persistence is indicated only as an unverified relationship.

Main entry points: [`client/src/App.js`](https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/client/src/App.js) (Route application), [`BACKEND/server.js`](https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/BACKEND/server.js) (Express API), [`BACKEND/controllers/transactions/transactionsCtrl.js`](https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/BACKEND/controllers/transactions/transactionsCtrl.js) (Transaction operations), [`BACKEND/model/User.js`](https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/BACKEND/model/User.js) (User records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React client"]
  node_app["Route application<br/>[App.js]"]
  node_home["Home and header<br/>[HomePage.js]"]
  node_navbar["Navigation<br/>[Navbar.js]"]
  node_authforms["Login and register"]
  node_accountforms["Account form<br/>[AddAccount.js]"]
  node_transactionform["Transaction form<br/>[AddTransaction.js]"]
  node_dashboard["Account dashboard"]
  node_accountdetails["Account details<br/>[AccountDetails.js]"]
  node_transactionviews["Income and expense views"]
end

subgraph group_auth["Identity and access"]
  node_authcontext["Auth context<br/>[AuthContext.js]"]
  node_accountcontext["Account context<br/>[AccountContext.js]"]
  node_transactioncontext["Transaction context"]
  node_apiurl["API URL config<br/>[apiUrl.js]"]
  node_login["Token authentication<br/>[isLogin.js]"]
end

subgraph group_domain["Finance operations"]
  node_api["Express API<br/>[server.js]"]
  node_useroutes["User routes<br/>[usersRoute.js]"]
  node_accountroutes["Account routes<br/>[accountsRoute.js]"]
  node_transactionroutes["Transaction routes"]
  node_userctrl["User operations<br/>[usersCtrl.js]"]
  node_accountctrl["Account operations<br/>[accountsCtrl.js]"]
  node_transactionctrl["Transaction operations"]
end

subgraph group_data["Domain data"]
  node_users[("User records<br/>[User.js]")]
  node_accounts[("Account records<br/>[Account.js]")]
  node_transactions[("Transaction records<br/>[Transaction.js]")]
end

node_visitor(("User"))
node_mongodb[("MongoDB")]

node_visitor -->|"uses"| node_app
node_app -->|"routes to"| node_home
node_app -->|"renders"| node_navbar
node_app -->|"routes to"| node_authforms
node_app -->|"routes to"| node_accountforms
node_app -->|"routes to"| node_transactionform
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_accountdetails
node_app -->|"routes to"| node_transactionviews
node_home -->|"renders"| node_navbar
node_authcontext -->|"uses endpoint config"| node_apiurl
node_accountcontext -->|"uses endpoint config"| node_apiurl
node_transactioncontext -->|"uses endpoint config"| node_apiurl
node_authcontext -->|"HTTP requests"| node_api
node_accountcontext -->|"HTTP requests"| node_api
node_transactioncontext -->|"HTTP requests"| node_api
node_api -->|"mounts routes"| node_useroutes
node_api -->|"mounts routes"| node_accountroutes
node_api -->|"mounts routes"| node_transactionroutes
node_useroutes -->|"dispatches to"| node_userctrl
node_useroutes -->|"applies auth"| node_login
node_accountroutes -->|"dispatches to"| node_accountctrl
node_accountroutes -->|"applies auth"| node_login
node_transactionroutes -->|"dispatches to"| node_transactionctrl
node_transactionroutes -->|"applies auth"| node_login
node_userctrl -->|"reads and writes"| node_users
node_accountctrl -->|"reads and updates"| node_users
node_accountctrl -->|"reads and writes"| node_accounts
node_transactionctrl -->|"reads"| node_users
node_transactionctrl -->|"reads and updates"| node_accounts
node_transactionctrl -->|"reads and writes"| node_transactions
node_users -.->|"persists in"| node_mongodb
node_accounts -.->|"persists in"| node_mongodb
node_transactions -.->|"persists in"| node_mongodb

click node_app "https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/client/src/App.js"
click node_home "https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/client/src/components/HomePage/HomePage.js"
click node_navbar "https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/client/src/components/Navbar/Navbar.js"
click node_authforms "https://github.com/dudamparthiv/income-expenses-tracker-app/tree/main/client/src/components/Forms"
click node_accountforms "https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/client/src/components/Forms/AddAccount.js"
click node_transactionform "https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/client/src/components/Forms/AddTransaction.js"
click node_dashboard "https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/client/src/components/Dashboard/AccountDashboard.js"
click node_accountdetails "https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/client/src/components/Dashboard/AccountDetails.js"
click node_transactionviews "https://github.com/dudamparthiv/income-expenses-tracker-app/tree/main/client/src/components/Dashboard"
click node_authcontext "https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/client/src/components/context/AuthContext/AuthContext.js"
click node_accountcontext "https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/client/src/components/context/AccountContext/AccountContext.js"
click node_transactioncontext "https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/client/src/components/context/TransactionContext/TransactionsContext.js"
click node_apiurl "https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/client/src/utils/apiUrl.js"
click node_api "https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/BACKEND/server.js"
click node_useroutes "https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/BACKEND/routes/users/usersRoute.js"
click node_accountroutes "https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/BACKEND/routes/accounts/accountsRoute.js"
click node_transactionroutes "https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/BACKEND/routes/transactions/transactionsRoute.js"
click node_login "https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/BACKEND/middlewares/isLogin.js"
click node_userctrl "https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/BACKEND/controllers/users/usersCtrl.js"
click node_accountctrl "https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/BACKEND/controllers/accounts/accountsCtrl.js"
click node_transactionctrl "https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/BACKEND/controllers/transactions/transactionsCtrl.js"
click node_users "https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/BACKEND/model/User.js"
click node_accounts "https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/BACKEND/model/Account.js"
click node_transactions "https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/BACKEND/model/Transaction.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_home,node_navbar,node_authforms,node_accountforms,node_transactionform,node_dashboard,node_accountdetails,node_transactionviews,node_visitor toneBlue
class node_authcontext,node_accountcontext,node_transactioncontext,node_apiurl,node_login,node_mongodb toneAmber
class node_api,node_useroutes,node_accountroutes,node_transactionroutes,node_userctrl,node_accountctrl,node_transactionctrl toneMint
class node_users,node_accounts,node_transactions toneRose
```

## Components

### React client

- [Route application](https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/client/src/App.js): `client/src/App.js`
- [Home and header](https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/client/src/components/HomePage/HomePage.js): `client/src/components/HomePage/HomePage.js`
- [Navigation](https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/client/src/components/Navbar/Navbar.js): `client/src/components/Navbar/Navbar.js`
- [Login and register](https://github.com/dudamparthiv/income-expenses-tracker-app/tree/main/client/src/components/Forms): `client/src/components/Forms`
- [Account form](https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/client/src/components/Forms/AddAccount.js): `client/src/components/Forms/AddAccount.js`
- [Transaction form](https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/client/src/components/Forms/AddTransaction.js): `client/src/components/Forms/AddTransaction.js`
- [Account dashboard](https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/client/src/components/Dashboard/AccountDashboard.js): `client/src/components/Dashboard/AccountDashboard.js`
- [Account details](https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/client/src/components/Dashboard/AccountDetails.js): `client/src/components/Dashboard/AccountDetails.js`
- [Income and expense views](https://github.com/dudamparthiv/income-expenses-tracker-app/tree/main/client/src/components/Dashboard): `client/src/components/Dashboard`

### Identity and access

- [Auth context](https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/client/src/components/context/AuthContext/AuthContext.js): `client/src/components/context/AuthContext/AuthContext.js`
- [Account context](https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/client/src/components/context/AccountContext/AccountContext.js): `client/src/components/context/AccountContext/AccountContext.js`
- [Transaction context](https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/client/src/components/context/TransactionContext/TransactionsContext.js): `client/src/components/context/TransactionContext/TransactionsContext.js`
- [API URL config](https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/client/src/utils/apiUrl.js): `client/src/utils/apiUrl.js`
- [Token authentication](https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/BACKEND/middlewares/isLogin.js): `BACKEND/middlewares/isLogin.js`

### Finance operations

- [Express API](https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/BACKEND/server.js): `BACKEND/server.js`
- [User routes](https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/BACKEND/routes/users/usersRoute.js): `BACKEND/routes/users/usersRoute.js`
- [Account routes](https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/BACKEND/routes/accounts/accountsRoute.js): `BACKEND/routes/accounts/accountsRoute.js`
- [Transaction routes](https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/BACKEND/routes/transactions/transactionsRoute.js): `BACKEND/routes/transactions/transactionsRoute.js`
- [User operations](https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/BACKEND/controllers/users/usersCtrl.js): `BACKEND/controllers/users/usersCtrl.js`
- [Account operations](https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/BACKEND/controllers/accounts/accountsCtrl.js): `BACKEND/controllers/accounts/accountsCtrl.js`
- [Transaction operations](https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/BACKEND/controllers/transactions/transactionsCtrl.js): `BACKEND/controllers/transactions/transactionsCtrl.js`

### Domain data

- [User records](https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/BACKEND/model/User.js): `BACKEND/model/User.js`
- [Account records](https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/BACKEND/model/Account.js): `BACKEND/model/Account.js`
- [Transaction records](https://github.com/dudamparthiv/income-expenses-tracker-app/blob/main/BACKEND/model/Transaction.js): `BACKEND/model/Transaction.js`

### Other components

- **User**
- **MongoDB**

## Connections

- User → Route application: uses (evidence: `client/src/App.js`)
- Route application → Home and header: routes to (evidence: `client/src/App.js`)
- Route application → Navigation: renders (evidence: `client/src/App.js`)
- Route application → Login and register: routes to (evidence: `client/src/App.js`)
- Route application → Account form: routes to (evidence: `client/src/App.js`)
- Route application → Transaction form: routes to (evidence: `client/src/App.js`)
- Route application → Account dashboard: routes to (evidence: `client/src/App.js`)
- Route application → Account details: routes to (evidence: `client/src/App.js`)
- Route application → Income and expense views: routes to (evidence: `client/src/App.js`)
- Home and header → Navigation: renders (evidence: `client/src/components/HomePage/HomePage.js`)
- Auth context → API URL config: uses endpoint config (evidence: `client/src/components/context/AuthContext/AuthContext.js`)
- Account context → API URL config: uses endpoint config (evidence: `client/src/components/context/AccountContext/AccountContext.js`)
- Transaction context → API URL config: uses endpoint config (evidence: `client/src/components/context/TransactionContext/TransactionsContext.js`)
- Auth context → Express API: HTTP requests (evidence: `client/src/components/context/AuthContext/AuthContext.js`)
- Account context → Express API: HTTP requests (evidence: `client/src/components/context/AccountContext/AccountContext.js`)
- Transaction context → Express API: HTTP requests (evidence: `client/src/components/context/TransactionContext/TransactionsContext.js`)
- Express API → User routes: mounts routes (evidence: `BACKEND/server.js`)
- Express API → Account routes: mounts routes (evidence: `BACKEND/server.js`)
- Express API → Transaction routes: mounts routes (evidence: `BACKEND/server.js`)
- User routes → User operations: dispatches to (evidence: `BACKEND/routes/users/usersRoute.js`)
- User routes → Token authentication: applies auth (evidence: `BACKEND/routes/users/usersRoute.js`)
- Account routes → Account operations: dispatches to (evidence: `BACKEND/routes/accounts/accountsRoute.js`)
- Account routes → Token authentication: applies auth (evidence: `BACKEND/routes/accounts/accountsRoute.js`)
- Transaction routes → Transaction operations: dispatches to (evidence: `BACKEND/routes/transactions/transactionsRoute.js`)
- Transaction routes → Token authentication: applies auth (evidence: `BACKEND/routes/transactions/transactionsRoute.js`)
- User operations → User records: reads and writes (evidence: `BACKEND/controllers/users/usersCtrl.js`)
- Account operations → User records: reads and updates (evidence: `BACKEND/controllers/accounts/accountsCtrl.js`)
- Account operations → Account records: reads and writes (evidence: `BACKEND/controllers/accounts/accountsCtrl.js`)
- Transaction operations → User records: reads (evidence: `BACKEND/controllers/transactions/transactionsCtrl.js`)
- Transaction operations → Account records: reads and updates (evidence: `BACKEND/controllers/transactions/transactionsCtrl.js`)
- Transaction operations → Transaction records: reads and writes (evidence: `BACKEND/controllers/transactions/transactionsCtrl.js`)
- User records → MongoDB: persists in
- Account records → MongoDB: persists in
- Transaction records → MongoDB: persists in
