# bouaboi/ex-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/bouaboi/ex-tracker
- Repository: https://github.com/bouaboi/ex-tracker

## Overview

Ex-Tracker is a browser-based personal income and expense tracker. Users enter or edit transactions, which are stored locally in IndexedDB; the application then presents transaction history and financial summaries, with category visualization, filtering, search, and pagination. Categories and currency preferences are also persisted locally. The runtime is implemented primarily in one JavaScript file, so the graph separates its responsibilities while retaining that shared source path. The README documents the broader capabilities; unsampled implementation details are not inferred beyond those documented behaviors.

Main entry points: [`app.js`](https://github.com/bouaboi/ex-tracker/blob/main/app.js) (View refresh), [`index.html`](https://github.com/bouaboi/ex-tracker/blob/main/index.html) (Tracker page), [`style.css`](https://github.com/bouaboi/ex-tracker/blob/main/style.css) (Responsive styling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Browser interface"]
  node_page["Tracker page<br/>[index.html]"]
  node_styles["Responsive styling<br/>[style.css]"]
end

subgraph group_transactions["Transaction tracking"]
  node_app["Application events<br/>[app.js]"]
  node_entry["Transaction entry<br/>[app.js]"]
  node_editing["Edit and delete<br/>[app.js]"]
  node_category["Custom categories<br/>[app.js]"]
end

subgraph group_insights["Summaries and discovery"]
  node_refresh["View refresh<br/>[app.js]"]
  node_totals["Balance totals<br/>[app.js]"]
  node_history["Transaction list<br/>[app.js]"]
  node_discovery["Filter and search<br/>[app.js]"]
  node_pages["Pagination<br/>[app.js]"]
  node_chart["Category chart<br/>[app.js]"]
  node_currency["Currency formatting<br/>[app.js]"]
end

subgraph group_localdata["Local persistence"]
  node_records[("Transaction records<br/>[app.js]")]
  node_categorydata[("Category records<br/>[app.js]")]
  node_preferences[("Currency preference<br/>[app.js]")]
end

node_user(("User"))

node_user -->|"opens"| node_page
node_page -->|"runs"| node_app
node_page -->|"uses"| node_styles
node_user -->|"enters transactions"| node_entry
node_app -->|"handles submit"| node_entry
node_entry -->|"writes"| node_records
node_user -->|"requests changes"| node_editing
node_app -->|"delegates clicks"| node_editing
node_editing -->|"reads and changes"| node_records
node_entry -->|"creates when needed"| node_category
node_category -->|"writes"| node_categorydata
node_app -->|"stores currency"| node_preferences
node_preferences -->|"restores selection"| node_refresh
node_records -->|"loads transactions"| node_refresh
node_refresh -->|"updates"| node_totals
node_refresh -->|"updates"| node_history
node_user -->|"filters and searches"| node_discovery
node_discovery -->|"narrows results"| node_history
node_history -->|"paginates"| node_pages
node_refresh -->|"updates"| node_chart
node_preferences -->|"provides selection"| node_currency
node_currency -->|"formats amounts"| node_totals

click node_page "https://github.com/bouaboi/ex-tracker/blob/main/index.html"
click node_styles "https://github.com/bouaboi/ex-tracker/blob/main/style.css"
click node_app "https://github.com/bouaboi/ex-tracker/blob/main/app.js"
click node_entry "https://github.com/bouaboi/ex-tracker/blob/main/app.js"
click node_editing "https://github.com/bouaboi/ex-tracker/blob/main/app.js"
click node_category "https://github.com/bouaboi/ex-tracker/blob/main/app.js"
click node_records "https://github.com/bouaboi/ex-tracker/blob/main/app.js"
click node_categorydata "https://github.com/bouaboi/ex-tracker/blob/main/app.js"
click node_preferences "https://github.com/bouaboi/ex-tracker/blob/main/app.js"
click node_refresh "https://github.com/bouaboi/ex-tracker/blob/main/app.js"
click node_totals "https://github.com/bouaboi/ex-tracker/blob/main/app.js"
click node_history "https://github.com/bouaboi/ex-tracker/blob/main/app.js"
click node_discovery "https://github.com/bouaboi/ex-tracker/blob/main/app.js"
click node_pages "https://github.com/bouaboi/ex-tracker/blob/main/app.js"
click node_chart "https://github.com/bouaboi/ex-tracker/blob/main/app.js"
click node_currency "https://github.com/bouaboi/ex-tracker/blob/main/app.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_page,node_styles,node_user toneBlue
class node_app,node_entry,node_editing,node_category toneAmber
class node_refresh,node_totals,node_history,node_discovery,node_pages,node_chart,node_currency toneMint
class node_records,node_categorydata,node_preferences toneRose
```

## Components

### Browser interface

- [Tracker page](https://github.com/bouaboi/ex-tracker/blob/main/index.html): `index.html`
- [Responsive styling](https://github.com/bouaboi/ex-tracker/blob/main/style.css): `style.css`

### Transaction tracking

- [Application events](https://github.com/bouaboi/ex-tracker/blob/main/app.js): `app.js`
- [Transaction entry](https://github.com/bouaboi/ex-tracker/blob/main/app.js): `app.js`
- [Edit and delete](https://github.com/bouaboi/ex-tracker/blob/main/app.js): `app.js`
- [Custom categories](https://github.com/bouaboi/ex-tracker/blob/main/app.js): `app.js`

### Summaries and discovery

- [View refresh](https://github.com/bouaboi/ex-tracker/blob/main/app.js): `app.js`
- [Balance totals](https://github.com/bouaboi/ex-tracker/blob/main/app.js): `app.js`
- [Transaction list](https://github.com/bouaboi/ex-tracker/blob/main/app.js): `app.js`
- [Filter and search](https://github.com/bouaboi/ex-tracker/blob/main/app.js): `app.js`
- [Pagination](https://github.com/bouaboi/ex-tracker/blob/main/app.js): `app.js`
- [Category chart](https://github.com/bouaboi/ex-tracker/blob/main/app.js): `app.js`
- [Currency formatting](https://github.com/bouaboi/ex-tracker/blob/main/app.js): `app.js`

### Local persistence

- [Transaction records](https://github.com/bouaboi/ex-tracker/blob/main/app.js): `app.js`
- [Category records](https://github.com/bouaboi/ex-tracker/blob/main/app.js): `app.js`
- [Currency preference](https://github.com/bouaboi/ex-tracker/blob/main/app.js): `app.js`

### Other components

- **User**

## Connections

- User → Tracker page: opens (evidence: `README.md`)
- Tracker page → Application events: runs (evidence: `README.md`)
- Tracker page → Responsive styling: uses (evidence: `README.md`)
- User → Transaction entry: enters transactions (evidence: `README.md`)
- Application events → Transaction entry: handles submit (evidence: `app.js`)
- Transaction entry → Transaction records: writes (evidence: `app.js`)
- User → Edit and delete: requests changes (evidence: `README.md`)
- Application events → Edit and delete: delegates clicks (evidence: `app.js`)
- Edit and delete → Transaction records: reads and changes (evidence: `app.js`)
- Transaction entry → Custom categories: creates when needed (evidence: `app.js`)
- Custom categories → Category records: writes (evidence: `app.js`)
- Application events → Currency preference: stores currency (evidence: `app.js`)
- Currency preference → View refresh: restores selection (evidence: `app.js`)
- Transaction records → View refresh: loads transactions (evidence: `app.js`)
- View refresh → Balance totals: updates (evidence: `README.md`)
- View refresh → Transaction list: updates (evidence: `README.md`)
- User → Filter and search: filters and searches (evidence: `README.md`)
- Filter and search → Transaction list: narrows results (evidence: `README.md`)
- Transaction list → Pagination: paginates (evidence: `README.md`)
- View refresh → Category chart: updates (evidence: `README.md`)
- Currency preference → Currency formatting: provides selection (evidence: `README.md`)
- Currency formatting → Balance totals: formats amounts (evidence: `README.md`)
