# rahulhaque/expense-tracker-react architecture

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

- Interactive diagram: https://gitdiagram.com/rahulhaque/expense-tracker-react
- Repository: https://github.com/rahulhaque/expense-tracker-react

## Overview

This is a React frontend for an expense-tracking service. Users enter through the landing or authentication screens, then use a protected dashboard to record and review income and expenses, manage categories, inspect calendar and chart summaries, and adjust profile and currency settings. The UI shares persisted global state and an Axios client that handles API requests and token refresh. The graph includes documented features whose source was not sampled; their internal links are omitted where the excerpts do not establish them.

Main entry points: [`src/app/layouts/DashboardLayout.jsx`](https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/layouts/DashboardLayout.jsx) (Dashboard layout), [`src/Axios.js`](https://github.com/rahulhaque/expense-tracker-react/blob/master/src/Axios.js) (HTTP client), [`src/Routes.jsx`](https://github.com/rahulhaque/expense-tracker-react/blob/master/src/Routes.jsx) (Route guards), [`src/app/dashboard/Dashboard.jsx`](https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/dashboard/Dashboard.jsx) (Dashboard summaries)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and navigation"]
  node_landing["Landing page<br/>[Website.jsx]"]
  node_auth["Login and registration"]
  node_routing["Route guards<br/>[Routes.jsx]"]
  node_dashboard_layout["Dashboard layout"]
end

subgraph group_finance["Transactions and reports"]
  node_dashboard["Dashboard summaries<br/>[Dashboard.jsx]"]
  node_expenses["Expense transactions<br/>[Expense.jsx]"]
  node_expense_categories["Expense categories"]
  node_expense_edits["Expense editing<br/>[EditExpense.jsx]"]
  node_incomes["Income transactions<br/>[Income.jsx]"]
  node_income_categories["Income categories<br/>[IncomeCategory.jsx]"]
  node_income_edits["Income editing<br/>[EditIncome.jsx]"]
  node_calendar["Transaction calendar"]
  node_analytics["Charts and analytics<br/>[Analytics.jsx]"]
end

subgraph group_account["Account and preferences"]
  node_profile["Profile management<br/>[Profile.jsx]"]
  node_profile_edit["Profile editing<br/>[EditProfile.jsx]"]
  node_settings["App settings<br/>[Setting.jsx]"]
  node_currency["Currency selection"]
  node_tools["Tools sidebar<br/>[ToolsSidebar.jsx]"]
  node_calculator["Calculator<br/>[Calculator.js]"]
end

subgraph group_shared["Shared frontend services"]
  node_api_client["HTTP client<br/>[Axios.js]"]
  node_api_endpoints["API endpoints<br/>[API.js]"]
  node_state["Shared persisted state<br/>[Store.js]"]
end

node_visitor(("User"))
node_backend{{"Expense Tracker API"}}

node_visitor -->|"opens app"| node_routing
node_routing -->|"routes to"| node_landing
node_routing -->|"routes guests"| node_auth
node_routing -->|"guards access"| node_dashboard_layout
node_dashboard_layout -->|"routes to"| node_dashboard
node_dashboard_layout -->|"routes to"| node_expenses
node_dashboard_layout -->|"routes to"| node_expense_categories
node_dashboard_layout -->|"routes to"| node_expense_edits
node_dashboard_layout -->|"routes to"| node_incomes
node_dashboard_layout -->|"routes to"| node_income_categories
node_dashboard_layout -->|"routes to"| node_income_edits
node_dashboard_layout -->|"routes to"| node_calendar
node_dashboard_layout -->|"routes to"| node_analytics
node_dashboard_layout -->|"routes to"| node_profile
node_dashboard_layout -->|"routes to"| node_profile_edit
node_dashboard_layout -->|"routes to"| node_settings
node_dashboard -->|"requests summaries"| node_api_client
node_expenses -->|"requests transactions"| node_api_client
node_incomes -->|"requests transactions"| node_api_client
node_calendar -->|"requests data"| node_api_client
node_analytics -->|"requests reports"| node_api_client
node_currency -->|"requests currencies"| node_api_client
node_settings -->|"updates currency"| node_api_client
node_api_client -->|"uses endpoints"| node_api_endpoints
node_api_client -->|"sends API requests"| node_backend
node_dashboard -->|"reads shared state"| node_state
node_currency -->|"updates selection"| node_state
node_settings -->|"updates preferences"| node_state
node_profile -->|"loads profile"| node_api_client
node_profile_edit -->|"updates profile"| node_api_client
node_tools -.->|"may provide access"| node_calculator

click node_landing "https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/landing/Website.jsx"
click node_auth "https://github.com/rahulhaque/expense-tracker-react/tree/master/src/app/auth"
click node_routing "https://github.com/rahulhaque/expense-tracker-react/blob/master/src/Routes.jsx"
click node_dashboard_layout "https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/layouts/DashboardLayout.jsx"
click node_dashboard "https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/dashboard/Dashboard.jsx"
click node_expenses "https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/expense/Expense.jsx"
click node_expense_categories "https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/expense/ExpenseCategory.jsx"
click node_expense_edits "https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/expense/EditExpense.jsx"
click node_incomes "https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/income/Income.jsx"
click node_income_categories "https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/income/IncomeCategory.jsx"
click node_income_edits "https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/income/EditIncome.jsx"
click node_calendar "https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/calendar/TransactionCalendar.jsx"
click node_analytics "https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/analytics/Analytics.jsx"
click node_profile "https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/profile/Profile.jsx"
click node_profile_edit "https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/profile/EditProfile.jsx"
click node_settings "https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/setting/Setting.jsx"
click node_currency "https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/common/CurrencySidebar.jsx"
click node_tools "https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/common/ToolsSidebar.jsx"
click node_calculator "https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/common/calculator/Calculator.js"
click node_api_client "https://github.com/rahulhaque/expense-tracker-react/blob/master/src/Axios.js"
click node_api_endpoints "https://github.com/rahulhaque/expense-tracker-react/blob/master/src/API.js"
click node_state "https://github.com/rahulhaque/expense-tracker-react/blob/master/src/Store.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_landing,node_auth,node_routing,node_dashboard_layout,node_visitor toneBlue
class node_dashboard,node_expenses,node_expense_categories,node_expense_edits,node_incomes,node_income_categories,node_income_edits,node_calendar,node_analytics toneAmber
class node_profile,node_profile_edit,node_settings,node_currency,node_tools,node_calculator,node_backend toneMint
class node_api_client,node_api_endpoints,node_state toneRose
```

## Components

### Entry and navigation

- [Landing page](https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/landing/Website.jsx): `src/app/landing/Website.jsx`
- [Login and registration](https://github.com/rahulhaque/expense-tracker-react/tree/master/src/app/auth): `src/app/auth`
- [Route guards](https://github.com/rahulhaque/expense-tracker-react/blob/master/src/Routes.jsx): `src/Routes.jsx`
- [Dashboard layout](https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/layouts/DashboardLayout.jsx): `src/app/layouts/DashboardLayout.jsx`

### Transactions and reports

- [Dashboard summaries](https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/dashboard/Dashboard.jsx): `src/app/dashboard/Dashboard.jsx`
- [Expense transactions](https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/expense/Expense.jsx): `src/app/expense/Expense.jsx`
- [Expense categories](https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/expense/ExpenseCategory.jsx): `src/app/expense/ExpenseCategory.jsx`
- [Expense editing](https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/expense/EditExpense.jsx): `src/app/expense/EditExpense.jsx`
- [Income transactions](https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/income/Income.jsx): `src/app/income/Income.jsx`
- [Income categories](https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/income/IncomeCategory.jsx): `src/app/income/IncomeCategory.jsx`
- [Income editing](https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/income/EditIncome.jsx): `src/app/income/EditIncome.jsx`
- [Transaction calendar](https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/calendar/TransactionCalendar.jsx): `src/app/calendar/TransactionCalendar.jsx`
- [Charts and analytics](https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/analytics/Analytics.jsx): `src/app/analytics/Analytics.jsx`

### Account and preferences

- [Profile management](https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/profile/Profile.jsx): `src/app/profile/Profile.jsx`
- [Profile editing](https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/profile/EditProfile.jsx): `src/app/profile/EditProfile.jsx`
- [App settings](https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/setting/Setting.jsx): `src/app/setting/Setting.jsx`
- [Currency selection](https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/common/CurrencySidebar.jsx): `src/app/common/CurrencySidebar.jsx`
- [Tools sidebar](https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/common/ToolsSidebar.jsx): `src/app/common/ToolsSidebar.jsx`
- [Calculator](https://github.com/rahulhaque/expense-tracker-react/blob/master/src/app/common/calculator/Calculator.js): `src/app/common/calculator/Calculator.js`

### Shared frontend services

- [HTTP client](https://github.com/rahulhaque/expense-tracker-react/blob/master/src/Axios.js): `src/Axios.js`
- [API endpoints](https://github.com/rahulhaque/expense-tracker-react/blob/master/src/API.js): `src/API.js`
- [Shared persisted state](https://github.com/rahulhaque/expense-tracker-react/blob/master/src/Store.js): `src/Store.js`

### Other components

- **User**
- **Expense Tracker API**

## Connections

- User → Route guards: opens app (evidence: `src/Routes.jsx`)
- Route guards → Landing page: routes to (evidence: `src/Routes.jsx`)
- Route guards → Login and registration: routes guests (evidence: `src/Routes.jsx`)
- Route guards → Dashboard layout: guards access (evidence: `src/Routes.jsx`)
- Dashboard layout → Dashboard summaries: routes to (evidence: `src/app/layouts/DashboardLayout.jsx`)
- Dashboard layout → Expense transactions: routes to (evidence: `src/app/layouts/DashboardLayout.jsx`)
- Dashboard layout → Expense categories: routes to (evidence: `src/app/layouts/DashboardLayout.jsx`)
- Dashboard layout → Expense editing: routes to (evidence: `src/app/layouts/DashboardLayout.jsx`)
- Dashboard layout → Income transactions: routes to (evidence: `src/app/layouts/DashboardLayout.jsx`)
- Dashboard layout → Income categories: routes to (evidence: `src/app/layouts/DashboardLayout.jsx`)
- Dashboard layout → Income editing: routes to (evidence: `src/app/layouts/DashboardLayout.jsx`)
- Dashboard layout → Transaction calendar: routes to (evidence: `src/app/layouts/DashboardLayout.jsx`)
- Dashboard layout → Charts and analytics: routes to (evidence: `src/app/layouts/DashboardLayout.jsx`)
- Dashboard layout → Profile management: routes to (evidence: `src/app/layouts/DashboardLayout.jsx`)
- Dashboard layout → Profile editing: routes to (evidence: `src/app/layouts/DashboardLayout.jsx`)
- Dashboard layout → App settings: routes to (evidence: `src/app/layouts/DashboardLayout.jsx`)
- Dashboard summaries → HTTP client: requests summaries (evidence: `src/app/dashboard/Dashboard.jsx`)
- Expense transactions → HTTP client: requests transactions (evidence: `src/app/expense/Expense.jsx`)
- Income transactions → HTTP client: requests transactions (evidence: `src/app/income/Income.jsx`)
- Transaction calendar → HTTP client: requests data (evidence: `src/app/calendar/TransactionCalendar.jsx`)
- Charts and analytics → HTTP client: requests reports (evidence: `src/app/analytics/Analytics.jsx`)
- Currency selection → HTTP client: requests currencies (evidence: `src/app/common/CurrencySidebar.jsx`)
- App settings → HTTP client: updates currency (evidence: `src/app/setting/Setting.jsx`)
- HTTP client → API endpoints: uses endpoints (evidence: `src/Axios.js`)
- HTTP client → Expense Tracker API: sends API requests (evidence: `src/Axios.js`)
- Dashboard summaries → Shared persisted state: reads shared state (evidence: `src/app/dashboard/Dashboard.jsx`)
- Currency selection → Shared persisted state: updates selection (evidence: `src/app/common/CurrencySidebar.jsx`)
- App settings → Shared persisted state: updates preferences (evidence: `src/app/setting/Setting.jsx`)
- Profile management → HTTP client: loads profile (evidence: `src/app/profile/Profile.jsx`)
- Profile editing → HTTP client: updates profile (evidence: `src/app/profile/EditProfile.jsx`)
- Tools sidebar → Calculator: may provide access
