# bradtraversy/expense-tracker-react architecture

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

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

## Overview

Expense Tracker is a client-side React application for recording income and expenses, removing transactions, and viewing the resulting balance, income, expense totals, and history. The principal workflow is: a user submits a transaction or deletes one; context dispatches the action through the reducer; React components consume the updated in-memory transaction state and render summaries and history. The sampled source shows no persistence or external service integration.

Main entry points: [`src/context/GlobalState.js`](https://github.com/bradtraversy/expense-tracker-react/blob/master/src/context/GlobalState.js) (Global Provider), [`src/App.js`](https://github.com/bradtraversy/expense-tracker-react/blob/master/src/App.js) (App Root), [`src/components/TransactionList.js`](https://github.com/bradtraversy/expense-tracker-react/blob/master/src/components/TransactionList.js) (Transaction List), [`src/components/AddTransaction.js`](https://github.com/bradtraversy/expense-tracker-react/blob/master/src/components/AddTransaction.js) (Add Transaction)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application Shell"]
  node_mount["React Mount<br/>[index.js]"]
  node_app_root["App Root<br/>[App.js]"]
  node_header["Header<br/>[Header.js]"]
end

subgraph group_state["Transaction State"]
  node_provider["Global Provider<br/>[GlobalState.js]"]
  node_reducer["App Reducer<br/>[AppReducer.js]"]
  node_transactions["Transaction State<br/>[GlobalState.js]"]
end

subgraph group_views["Transaction Views"]
  node_add_transaction["Add Transaction<br/>[AddTransaction.js]"]
  node_transaction_list["Transaction List<br/>[TransactionList.js]"]
  node_transaction["Transaction Item<br/>[Transaction.js]"]
  node_balance["Balance Summary<br/>[Balance.js]"]
  node_income_expenses["Income Expenses<br/>[IncomeExpenses.js]"]
end

node_user(("User"))

node_mount -->|"renders"| node_app_root
node_app_root -->|"wraps"| node_provider
node_app_root -->|"renders"| node_header
node_app_root -->|"renders"| node_balance
node_app_root -->|"renders"| node_income_expenses
node_app_root -->|"renders"| node_transaction_list
node_app_root -->|"renders"| node_add_transaction
node_user -->|"submits"| node_add_transaction
node_add_transaction -->|"adds transaction"| node_provider
node_provider -->|"dispatches"| node_reducer
node_reducer -->|"updates"| node_transactions
node_provider -->|"provides actions"| node_add_transaction
node_provider -->|"provides state"| node_transaction_list
node_provider -->|"provides action"| node_transaction
node_provider -->|"provides state"| node_balance
node_provider -->|"provides state"| node_income_expenses
node_transaction_list -->|"renders items"| node_transaction
node_user -->|"deletes"| node_transaction
node_transaction -->|"deletes transaction"| node_provider
node_balance -->|"reads state"| node_transactions
node_income_expenses -->|"reads state"| node_transactions
node_transaction_list -->|"reads state"| node_transactions

click node_mount "https://github.com/bradtraversy/expense-tracker-react/blob/master/src/index.js"
click node_app_root "https://github.com/bradtraversy/expense-tracker-react/blob/master/src/App.js"
click node_header "https://github.com/bradtraversy/expense-tracker-react/blob/master/src/components/Header.js"
click node_provider "https://github.com/bradtraversy/expense-tracker-react/blob/master/src/context/GlobalState.js"
click node_reducer "https://github.com/bradtraversy/expense-tracker-react/blob/master/src/context/AppReducer.js"
click node_transactions "https://github.com/bradtraversy/expense-tracker-react/blob/master/src/context/GlobalState.js"
click node_add_transaction "https://github.com/bradtraversy/expense-tracker-react/blob/master/src/components/AddTransaction.js"
click node_transaction_list "https://github.com/bradtraversy/expense-tracker-react/blob/master/src/components/TransactionList.js"
click node_transaction "https://github.com/bradtraversy/expense-tracker-react/blob/master/src/components/Transaction.js"
click node_balance "https://github.com/bradtraversy/expense-tracker-react/blob/master/src/components/Balance.js"
click node_income_expenses "https://github.com/bradtraversy/expense-tracker-react/blob/master/src/components/IncomeExpenses.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_mount,node_app_root,node_header,node_user toneBlue
class node_provider,node_reducer,node_transactions toneAmber
class node_add_transaction,node_transaction_list,node_transaction,node_balance,node_income_expenses toneMint
```

## Components

### Application Shell

- [React Mount](https://github.com/bradtraversy/expense-tracker-react/blob/master/src/index.js): `src/index.js`
- [App Root](https://github.com/bradtraversy/expense-tracker-react/blob/master/src/App.js): `src/App.js`
- [Header](https://github.com/bradtraversy/expense-tracker-react/blob/master/src/components/Header.js): `src/components/Header.js`

### Transaction State

- [Global Provider](https://github.com/bradtraversy/expense-tracker-react/blob/master/src/context/GlobalState.js): `src/context/GlobalState.js`
- [App Reducer](https://github.com/bradtraversy/expense-tracker-react/blob/master/src/context/AppReducer.js): `src/context/AppReducer.js`
- [Transaction State](https://github.com/bradtraversy/expense-tracker-react/blob/master/src/context/GlobalState.js): `src/context/GlobalState.js`

### Transaction Views

- [Add Transaction](https://github.com/bradtraversy/expense-tracker-react/blob/master/src/components/AddTransaction.js): `src/components/AddTransaction.js`
- [Transaction List](https://github.com/bradtraversy/expense-tracker-react/blob/master/src/components/TransactionList.js): `src/components/TransactionList.js`
- [Transaction Item](https://github.com/bradtraversy/expense-tracker-react/blob/master/src/components/Transaction.js): `src/components/Transaction.js`
- [Balance Summary](https://github.com/bradtraversy/expense-tracker-react/blob/master/src/components/Balance.js): `src/components/Balance.js`
- [Income Expenses](https://github.com/bradtraversy/expense-tracker-react/blob/master/src/components/IncomeExpenses.js): `src/components/IncomeExpenses.js`

### Other components

- **User**

## Connections

- React Mount → App Root: renders
- App Root → Global Provider: wraps
- App Root → Header: renders
- App Root → Balance Summary: renders
- App Root → Income Expenses: renders
- App Root → Transaction List: renders
- App Root → Add Transaction: renders
- User → Add Transaction: submits
- Add Transaction → Global Provider: adds transaction
- Global Provider → App Reducer: dispatches
- App Reducer → Transaction State: updates
- Global Provider → Add Transaction: provides actions
- Global Provider → Transaction List: provides state
- Global Provider → Transaction Item: provides action
- Global Provider → Balance Summary: provides state
- Global Provider → Income Expenses: provides state
- Transaction List → Transaction Item: renders items
- User → Transaction Item: deletes
- Transaction Item → Global Provider: deletes transaction
- Balance Summary → Transaction State: reads state
- Income Expenses → Transaction State: reads state
- Transaction List → Transaction State: reads state
