# ajaykreigns/kaasu-2.o-premium-expenses-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/ajaykreigns/kaasu-2.o-premium-expenses-tracker
- Repository: https://github.com/ajaykreigns/kaasu-2.o-premium-expenses-tracker

## Overview

Kaasu is an expense-tracking application presented as a browser UI and launched in a desktop Electron window. The visible workflow initializes the interface, loads transaction and budget records from IndexedDB, and refreshes the dashboard and charts; users can manage transactions and budgets, inspect analytics and reports, and import or export CSV data. The README also advertises account/liability tracking, goals, PDF reports, and Google-auth cloud sync, but the supplied excerpts do not establish their implementation or wiring. Arrows are limited to relationships evidenced by excerpts or README statements.

Main entry points: [`app.js`](https://github.com/ajaykreigns/kaasu-2.o-premium-expenses-tracker/blob/main/app.js) (Application logic), [`main.js`](https://github.com/ajaykreigns/kaasu-2.o-premium-expenses-tracker/blob/main/main.js) (Electron window)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["App runtime"]
  node_electron["Electron window<br/>[main.js]"]
  node_app["Application logic<br/>[app.js]"]
end

subgraph group_finance["Financial tracking"]
  node_transactions["Transactions<br/>[app.js]"]
  node_budgets["Budgets and goals<br/>[app.js]"]
  node_accounts["Accounts and liabilities"]
end

subgraph group_insights["Insights and reporting"]
  node_dashboard["Dashboard<br/>[app.js]"]
  node_charts["Visual analytics<br/>[app.js]"]
  node_reports["Reports and PDF<br/>[app.js]"]
end

subgraph group_data["Local data"]
  node_csv["CSV migration<br/>[app.js]"]
  node_indexeddb[("IndexedDB records<br/>[app.js]")]
  node_cloud["Google-auth sync"]
end

node_user(("User"))

node_user -->|"opens app"| node_electron
node_electron -->|"loads interface"| node_app
node_app -->|"loads and saves"| node_indexeddb
node_app -->|"refreshes"| node_dashboard
node_app -->|"initializes"| node_charts
node_user -.->|"manages"| node_transactions
node_transactions -->|"persists records"| node_indexeddb
node_user -.->|"sets limits"| node_budgets
node_budgets -->|"persists records"| node_indexeddb
node_user -.->|"tracks accounts"| node_accounts
node_user -.->|"requests summaries"| node_reports
node_user -->|"imports or exports"| node_csv
node_csv -.->|"migrates data"| node_indexeddb
node_cloud -.->|"syncs account data"| node_user

click node_electron "https://github.com/ajaykreigns/kaasu-2.o-premium-expenses-tracker/blob/main/main.js"
click node_app "https://github.com/ajaykreigns/kaasu-2.o-premium-expenses-tracker/blob/main/app.js"
click node_transactions "https://github.com/ajaykreigns/kaasu-2.o-premium-expenses-tracker/blob/main/app.js"
click node_budgets "https://github.com/ajaykreigns/kaasu-2.o-premium-expenses-tracker/blob/main/app.js"
click node_dashboard "https://github.com/ajaykreigns/kaasu-2.o-premium-expenses-tracker/blob/main/app.js"
click node_charts "https://github.com/ajaykreigns/kaasu-2.o-premium-expenses-tracker/blob/main/app.js"
click node_reports "https://github.com/ajaykreigns/kaasu-2.o-premium-expenses-tracker/blob/main/app.js"
click node_csv "https://github.com/ajaykreigns/kaasu-2.o-premium-expenses-tracker/blob/main/app.js"
click node_indexeddb "https://github.com/ajaykreigns/kaasu-2.o-premium-expenses-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_electron,node_app,node_user toneBlue
class node_transactions,node_budgets,node_accounts toneAmber
class node_dashboard,node_charts,node_reports toneMint
class node_csv,node_indexeddb,node_cloud toneRose
```

## Components

### App runtime

- [Electron window](https://github.com/ajaykreigns/kaasu-2.o-premium-expenses-tracker/blob/main/main.js): `main.js`
- [Application logic](https://github.com/ajaykreigns/kaasu-2.o-premium-expenses-tracker/blob/main/app.js): `app.js`

### Financial tracking

- [Transactions](https://github.com/ajaykreigns/kaasu-2.o-premium-expenses-tracker/blob/main/app.js): `app.js`
- [Budgets and goals](https://github.com/ajaykreigns/kaasu-2.o-premium-expenses-tracker/blob/main/app.js): `app.js`
- **Accounts and liabilities**

### Insights and reporting

- [Dashboard](https://github.com/ajaykreigns/kaasu-2.o-premium-expenses-tracker/blob/main/app.js): `app.js`
- [Visual analytics](https://github.com/ajaykreigns/kaasu-2.o-premium-expenses-tracker/blob/main/app.js): `app.js`
- [Reports and PDF](https://github.com/ajaykreigns/kaasu-2.o-premium-expenses-tracker/blob/main/app.js): `app.js`

### Local data

- [CSV migration](https://github.com/ajaykreigns/kaasu-2.o-premium-expenses-tracker/blob/main/app.js): `app.js`
- [IndexedDB records](https://github.com/ajaykreigns/kaasu-2.o-premium-expenses-tracker/blob/main/app.js): `app.js`
- **Google-auth sync**

### Other components

- **User**

## Connections

- User → Electron window: opens app (evidence: `main.js`)
- Electron window → Application logic: loads interface (evidence: `main.js`)
- Application logic → IndexedDB records: loads and saves (evidence: `app.js`)
- Application logic → Dashboard: refreshes (evidence: `app.js`)
- Application logic → Visual analytics: initializes (evidence: `app.js`)
- User → Transactions: manages
- Transactions → IndexedDB records: persists records (evidence: `app.js`)
- User → Budgets and goals: sets limits
- Budgets and goals → IndexedDB records: persists records (evidence: `app.js`)
- User → Accounts and liabilities: tracks accounts (evidence: `README.md`)
- User → Reports and PDF: requests summaries (evidence: `README.md`)
- User → CSV migration: imports or exports (evidence: `app.js`)
- CSV migration → IndexedDB records: migrates data (evidence: `app.js`)
- Google-auth sync → User: syncs account data (evidence: `README.md`)
