# himanshu-tech-pro/expance-tracker architecture

> Architecture diagram of the GitHub repository himanshu-tech-pro/expance-tracker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-24). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/himanshu-tech-pro/expance-tracker
- Repository: https://github.com/himanshu-tech-pro/expance-tracker

## Overview

##### Project type and purpose
- This is a full-stack web application (“Expense Tracker”) that lets users record, edit, delete, and view income and expense transactions in real time.
- Frontend is built in React.js, backend in Node.js/Express, data stored in MongoDB via Mongoose.

##### File structure
- Top-level folders:
- backend/ – Express server, controllers, models, routes, MongoDB connection code
- frontend/ – React application: public assets, src with components, context, utils, styling
- Configuration and entry points:
- backend/app.js (Express setup, route mounting)
- backend/db/db.js (Mongoose connection)
- frontend/src/index.js (React DOM render)
- Follows a classic MVC pattern on backend (routes → controllers → models) and a component-based architecture on frontend (UI components + global context for state).

##### README for additional insights
- Lists tech stack, key features, deployment targets (Vercel/Netlify for frontend, Render for backend).
- Mentions MongoDB database, Axios for API calls, Tailwind or CSS Modules for styling.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph "Frontend Layer"
        Browser["Browser / React App"]:::frontend
        subgraph "Frontend Codebase"
            Index["index.js"]:::frontend
            App["App.js"]:::frontend
            Dashboard["Dashboard"]:::frontend
            ExpenseForm["ExpenseForm"]:::frontend
            ExpensesList["ExpensesList"]:::frontend
            IncomeComp["Income"]:::frontend
            ChartComp["Chart"]:::frontend
            GlobalContext["GlobalContext"]:::frontend
            dateFormat["dateFormat()"]:::frontend
            Icons["Icons"]:::frontend
            menuItems["menuItems"]:::frontend
            useWindowSize["useWindowSize()"]:::frontend
        end
    end

    subgraph "Backend Layer (Express Server)"
        Server["app.js"]:::backend
        DBConn["db/db.js"]:::backend
        Routes["transactions.js"]:::backend
        ExpenseCtrl["ExpenseController"]:::backend
        IncomeCtrl["IncomeController"]:::backend
        ExpenseModel["ExpenseModel"]:::backend
        IncomeModel["IncomeModel"]:::backend
    end

    Database["MongoDB Atlas Cluster"]:::database

    subgraph "Deployment"
        FrontendHost["Vercel/Netlify"]:::external
        BackendHost["Render"]:::external
        Env[".env (DOTENV)"]:::external
    end

    Browser -->|renders| Index
    Index -->|renders| App
    App -->|uses| Dashboard
    App -->|uses| ExpenseForm
    App -->|uses| ExpensesList
    App -->|uses| IncomeComp
    App -->|uses| ChartComp
    App -->|wraps| GlobalContext
    App -->|imports| dateFormat
    App -->|imports| Icons
    App -->|imports| menuItems
    App -->|imports| useWindowSize

    Browser -->|axios API calls| Routes

    Server -->|connects to| DBConn
    Server -->|mounts| Routes
    Routes -->|calls| ExpenseCtrl
    Routes -->|calls| IncomeCtrl
    ExpenseCtrl -->|queries| ExpenseModel
    IncomeCtrl -->|queries| IncomeModel
    ExpenseModel -->|persists| Database
    IncomeModel -->|persists| Database

    DBConn -->|connects| Database

    FrontendHost -.->|deploys| Browser
    BackendHost -.->|deploys| Server
    Server -.->|uses| Env
    Database -.->|secured via| Env

    click Index "https://github.com/himanshu-tech-pro/expance-tracker/blob/main/frontend/src/index.js"
    click App "https://github.com/himanshu-tech-pro/expance-tracker/blob/main/frontend/src/App.js"
    click Dashboard "https://github.com/himanshu-tech-pro/expance-tracker/blob/main/frontend/src/Components/Dashboard/Dashboard.js"
    click ExpenseForm "https://github.com/himanshu-tech-pro/expance-tracker/blob/main/frontend/src/Components/Expenses/ExpenseForm.js"
    click ExpensesList "https://github.com/himanshu-tech-pro/expance-tracker/blob/main/frontend/src/Components/Expenses/Expenses.js"
    click IncomeComp "https://github.com/himanshu-tech-pro/expance-tracker/blob/main/frontend/src/Components/Income/Income.js"
    click ChartComp "https://github.com/himanshu-tech-pro/expance-tracker/blob/main/frontend/src/Components/Chart/Chart.js"
    click GlobalContext "https://github.com/himanshu-tech-pro/expance-tracker/blob/main/frontend/src/context/globalContext.js"
    click dateFormat "https://github.com/himanshu-tech-pro/expance-tracker/blob/main/frontend/src/utils/dateFormat.js"
    click Icons "https://github.com/himanshu-tech-pro/expance-tracker/blob/main/frontend/src/utils/Icons.js"
    click menuItems "https://github.com/himanshu-tech-pro/expance-tracker/blob/main/frontend/src/utils/menuItems.js"
    click useWindowSize "https://github.com/himanshu-tech-pro/expance-tracker/blob/main/frontend/src/utils/useWindowSize.js"
    click Server "https://github.com/himanshu-tech-pro/expance-tracker/blob/main/backend/app.js"
    click DBConn "https://github.com/himanshu-tech-pro/expance-tracker/blob/main/backend/db/db.js"
    click Routes "https://github.com/himanshu-tech-pro/expance-tracker/blob/main/backend/routes/transactions.js"
    click ExpenseCtrl "https://github.com/himanshu-tech-pro/expance-tracker/blob/main/backend/controllers/expense.js"
    click IncomeCtrl "https://github.com/himanshu-tech-pro/expance-tracker/blob/main/backend/controllers/income.js"
    click ExpenseModel "https://github.com/himanshu-tech-pro/expance-tracker/blob/main/backend/models/ExpenseModel.js"
    click IncomeModel "https://github.com/himanshu-tech-pro/expance-tracker/blob/main/backend/models/IncomeModel.js"

    classDef frontend fill:#cfe2ff,stroke:#084298,stroke-width:1px
    classDef backend fill:#d1e7dd,stroke:#0f5132,stroke-width:1px
    classDef database fill:#fff3cd,stroke:#664d03,stroke-width:1px
    classDef external fill:#e2e3e5,stroke:#6c757d,stroke-width:1px
```
