# kentadoniram/sukliapp architecture

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

- Interactive diagram: https://gitdiagram.com/kentadoniram/sukliapp
- Repository: https://github.com/kentadoniram/sukliapp

## Overview

Sukli is a private, browser-based money tracker: users record or import financial activity, organize it into accounts and categories, then review spending, balances, budgets, and investments. Its core data layer keeps a JSON database on-device; Google Drive backup is optional. The graph preserves the documented budgeting, goals, debt, receipt capture, and investment capabilities. Some branches are represented by their exact source paths but were not sampled, so their internal connections are omitted; only evidenced or documented relationships are drawn.

Main entry points: [`js/core.js`](https://github.com/kentadoniram/sukliapp/blob/main/js/core.js) (Local data store), [`js/app.js`](https://github.com/kentadoniram/sukliapp/blob/main/js/app.js) (App orchestration), [`js/entry.js`](https://github.com/kentadoniram/sukliapp/blob/main/js/entry.js) (Entry editor), [`js/views.js`](https://github.com/kentadoniram/sukliapp/blob/main/js/views.js) (Finance views)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["App experience"]
  node_app["App orchestration<br/>[app.js]"]
  node_screens["Home and screens<br/>[screens.js]"]
  node_views["Finance views<br/>[views.js]"]
end

subgraph group_records["Money records"]
  node_entry["Entry editor<br/>[entry.js]"]
  node_receipt["Receipt capture<br/>[scan.js]"]
  node_accounts["Accounts<br/>[accpage.js]"]
  node_categories["Category suggestions<br/>[catsuggest.js]"]
  node_reimburse["Reimbursements<br/>[reimburse.js]"]
end

subgraph group_planning["Planning and analysis"]
  node_budget["Budget setup<br/>[budgetsetup.js]"]
  node_analysis["Spending analysis<br/>[finance.js]"]
  node_stats["Statistics<br/>[stats.js]"]
  node_savings["Savings goals<br/>[savings.js]"]
  node_debts["Debts and loans<br/>[debts.js]"]
end

subgraph group_investing["Investments"]
  node_invest["Investment tracking<br/>[invest.js]"]
  node_trades["Trade records<br/>[trades.js]"]
  node_market["Market data<br/>[market.js]"]
end

subgraph group_support["Data and integrations"]
  node_ledger[("Local data store<br/>[core.js]")]
  node_importer["Data import<br/>[importer.js]"]
  node_backup["Drive backup<br/>[backup.js]"]
end

node_user(("User"))
node_drive[("Google Drive")]

node_user -->|"uses"| node_app
node_app -->|"opens"| node_screens
node_app -->|"routes to"| node_entry
node_app -->|"routes to"| node_accounts
node_app -->|"invokes"| node_importer
node_app -->|"invokes"| node_backup
node_screens -->|"reads"| node_ledger
node_entry -->|"updates"| node_ledger
node_accounts -->|"updates"| node_ledger
node_receipt -->|"opens editor"| node_entry
node_views -->|"uses"| node_screens
node_views -->|"uses"| node_budget
node_views -->|"uses"| node_analysis
node_analysis -->|"uses"| node_stats
node_budget -->|"reads"| node_ledger
node_savings -->|"updates"| node_ledger
node_debts -->|"reads"| node_ledger
node_reimburse -->|"updates"| node_ledger
node_invest -->|"uses"| node_ledger
node_trades -->|"uses"| node_invest
node_invest -->|"uses"| node_market
node_backup -.->|"backs up to"| node_drive
node_categories -.->|"suggests categories"| node_entry

click node_app "https://github.com/kentadoniram/sukliapp/blob/main/js/app.js"
click node_screens "https://github.com/kentadoniram/sukliapp/blob/main/js/screens.js"
click node_views "https://github.com/kentadoniram/sukliapp/blob/main/js/views.js"
click node_entry "https://github.com/kentadoniram/sukliapp/blob/main/js/entry.js"
click node_receipt "https://github.com/kentadoniram/sukliapp/blob/main/js/scan.js"
click node_accounts "https://github.com/kentadoniram/sukliapp/blob/main/js/accpage.js"
click node_ledger "https://github.com/kentadoniram/sukliapp/blob/main/js/core.js"
click node_categories "https://github.com/kentadoniram/sukliapp/blob/main/js/catsuggest.js"
click node_importer "https://github.com/kentadoniram/sukliapp/blob/main/js/importer.js"
click node_backup "https://github.com/kentadoniram/sukliapp/blob/main/js/backup.js"
click node_budget "https://github.com/kentadoniram/sukliapp/blob/main/js/budgetsetup.js"
click node_analysis "https://github.com/kentadoniram/sukliapp/blob/main/js/finance.js"
click node_stats "https://github.com/kentadoniram/sukliapp/blob/main/js/stats.js"
click node_savings "https://github.com/kentadoniram/sukliapp/blob/main/js/savings.js"
click node_debts "https://github.com/kentadoniram/sukliapp/blob/main/js/debts.js"
click node_reimburse "https://github.com/kentadoniram/sukliapp/blob/main/js/reimburse.js"
click node_invest "https://github.com/kentadoniram/sukliapp/blob/main/js/invest.js"
click node_trades "https://github.com/kentadoniram/sukliapp/blob/main/js/trades.js"
click node_market "https://github.com/kentadoniram/sukliapp/blob/main/js/market.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_app,node_screens,node_views,node_user toneBlue
class node_entry,node_receipt,node_accounts,node_categories,node_reimburse,node_drive toneAmber
class node_budget,node_analysis,node_stats,node_savings,node_debts toneMint
class node_invest,node_trades,node_market toneRose
class node_ledger,node_importer,node_backup toneIndigo
```

## Components

### App experience

- [App orchestration](https://github.com/kentadoniram/sukliapp/blob/main/js/app.js): `js/app.js`
- [Home and screens](https://github.com/kentadoniram/sukliapp/blob/main/js/screens.js): `js/screens.js`
- [Finance views](https://github.com/kentadoniram/sukliapp/blob/main/js/views.js): `js/views.js`

### Money records

- [Entry editor](https://github.com/kentadoniram/sukliapp/blob/main/js/entry.js): `js/entry.js`
- [Receipt capture](https://github.com/kentadoniram/sukliapp/blob/main/js/scan.js): `js/scan.js`
- [Accounts](https://github.com/kentadoniram/sukliapp/blob/main/js/accpage.js): `js/accpage.js`
- [Category suggestions](https://github.com/kentadoniram/sukliapp/blob/main/js/catsuggest.js): `js/catsuggest.js`
- [Reimbursements](https://github.com/kentadoniram/sukliapp/blob/main/js/reimburse.js): `js/reimburse.js`

### Planning and analysis

- [Budget setup](https://github.com/kentadoniram/sukliapp/blob/main/js/budgetsetup.js): `js/budgetsetup.js`
- [Spending analysis](https://github.com/kentadoniram/sukliapp/blob/main/js/finance.js): `js/finance.js`
- [Statistics](https://github.com/kentadoniram/sukliapp/blob/main/js/stats.js): `js/stats.js`
- [Savings goals](https://github.com/kentadoniram/sukliapp/blob/main/js/savings.js): `js/savings.js`
- [Debts and loans](https://github.com/kentadoniram/sukliapp/blob/main/js/debts.js): `js/debts.js`

### Investments

- [Investment tracking](https://github.com/kentadoniram/sukliapp/blob/main/js/invest.js): `js/invest.js`
- [Trade records](https://github.com/kentadoniram/sukliapp/blob/main/js/trades.js): `js/trades.js`
- [Market data](https://github.com/kentadoniram/sukliapp/blob/main/js/market.js): `js/market.js`

### Data and integrations

- [Local data store](https://github.com/kentadoniram/sukliapp/blob/main/js/core.js): `js/core.js`
- [Data import](https://github.com/kentadoniram/sukliapp/blob/main/js/importer.js): `js/importer.js`
- [Drive backup](https://github.com/kentadoniram/sukliapp/blob/main/js/backup.js): `js/backup.js`

### Other components

- **User**
- **Google Drive**

## Connections

- User → App orchestration: uses
- App orchestration → Home and screens: opens (evidence: `js/app.js`)
- App orchestration → Entry editor: routes to (evidence: `js/app.js`)
- App orchestration → Accounts: routes to (evidence: `js/app.js`)
- App orchestration → Data import: invokes (evidence: `js/app.js`)
- App orchestration → Drive backup: invokes (evidence: `js/app.js`)
- Home and screens → Local data store: reads (evidence: `js/screens.js`)
- Entry editor → Local data store: updates (evidence: `js/entry.js`)
- Accounts → Local data store: updates (evidence: `js/accpage.js`)
- Receipt capture → Entry editor: opens editor (evidence: `js/scan.js`)
- Finance views → Home and screens: uses (evidence: `js/views.js`)
- Finance views → Budget setup: uses (evidence: `js/views.js`)
- Finance views → Spending analysis: uses (evidence: `js/views.js`)
- Spending analysis → Statistics: uses (evidence: `js/finance.js`)
- Budget setup → Local data store: reads (evidence: `js/budgetsetup.js`)
- Savings goals → Local data store: updates (evidence: `js/savings.js`)
- Debts and loans → Local data store: reads (evidence: `js/debts.js`)
- Reimbursements → Local data store: updates (evidence: `js/reimburse.js`)
- Investment tracking → Local data store: uses (evidence: `js/invest.js`)
- Trade records → Investment tracking: uses (evidence: `js/trades.js`)
- Investment tracking → Market data: uses (evidence: `js/invest.js`)
- Drive backup → Google Drive: backs up to
- Category suggestions → Entry editor: suggests categories (evidence: `js/entry.js`)
