# nvm2478/flowt architecture

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

- Interactive diagram: https://gitdiagram.com/nvm2478/flowt
- Repository: https://github.com/nvm2478/flowt

## Overview

Flowt is an Android personal-expense ledger. Users record and edit transactions, browse a categorized ledger and reports, configure metrics and appearance, and import or export bill files. The main route is Activity → app state/navigation → entry UI → transaction repository → Room; the same state layer supplies ledger/report views. Import includes parsing, mapping, duplicate review, and persistence; export builds and encodes tables. The index identifies other subsystems, but their internal calls are not asserted where excerpts do not show them.

Main entry points: [`app/src/main/java/com/flowt/app/ui/AppViewModel.kt`](https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/ui/AppViewModel.kt) (App state), [`app/src/main/java/com/flowt/app/ui/FlowtApp.kt`](https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/ui/FlowtApp.kt) (App navigation), [`app/src/main/java/com/flowt/app/data/bill/ImportService.kt`](https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/data/bill/ImportService.kt) (Import planning), [`app/src/main/java/com/flowt/app/data/bill/ExportService.kt`](https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/data/bill/ExportService.kt) (Export service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and screens"]
  node_activity["Android activity<br/>[MainActivity.kt]"]
  node_app_ui["App navigation<br/>[FlowtApp.kt]"]
  node_entry["Entry and edit<br/>[EntryScreen.kt]"]
  node_ledger_screen["Ledger view<br/>[LedgerScreen.kt]"]
  node_report["Reports<br/>[ReportScreen.kt]"]
  node_settings["Settings"]
  node_state["App state<br/>[AppViewModel.kt]"]
end

subgraph group_ledger["Ledger data"]
  node_tx_repo["Transaction repository<br/>[TxRepository.kt]"]
  node_category_repo["Category repository"]
  node_transaction["Transactions"]
  node_category["Category tree<br/>[Category.kt]"]
  node_database[("Room database<br/>[FlowtDatabase.kt]")]
end

subgraph group_files["Bill interchange"]
  node_import_ui["Import review<br/>[ImportScreen.kt]"]
  node_import_service["Import planning<br/>[ImportService.kt]"]
  node_bill_table["Bill table parsing<br/>[BillTable.kt]"]
  node_export_service["Export service<br/>[ExportService.kt]"]
  node_csv_io["CSV codecs<br/>[CsvWriter.kt]"]
  node_xlsx_io["XLSX codecs<br/>[XlsxWriter.kt]"]
end

subgraph group_insights["Metrics"]
  node_metrics["Metric calculations<br/>[MetricValue.kt]"]
  node_metric_def["Metric definitions<br/>[LedgerMetric.kt]"]
end

subgraph group_appearance["Appearance"]
  node_prefs[("Preferences<br/>[PrefsRepository.kt]")]
  node_theme["Theme roles<br/>[FlowtTheme.kt]"]
  node_colors["Color palette<br/>[FlowtColors.kt]"]
end

node_user(("User"))

node_user -->|"opens app"| node_activity
node_activity -->|"sets content"| node_app_ui
node_activity -->|"creates"| node_state
node_activity -->|"applies"| node_theme
node_user -.->|"records spending"| node_entry
node_app_ui -->|"shows"| node_entry
node_app_ui -->|"shows"| node_ledger_screen
node_app_ui -->|"shows"| node_report
node_app_ui -->|"shows"| node_settings
node_entry -->|"uses"| node_state
node_state -->|"observes and updates"| node_tx_repo
node_state -->|"uses"| node_category_repo
node_state -->|"invokes"| node_import_service
node_state -->|"invokes"| node_export_service
node_ledger_screen -.->|"reads state"| node_state
node_report -.->|"reads state"| node_state
node_tx_repo -->|"accesses"| node_database
node_category_repo -->|"accesses"| node_database
node_database -->|"stores"| node_transaction
node_database -->|"stores"| node_category
node_import_ui -->|"requests import"| node_state
node_import_service -->|"parses rows"| node_bill_table
node_import_service -->|"loads and creates categories"| node_category_repo
node_import_service -->|"checks and inserts"| node_tx_repo
node_import_service -->|"records imported file"| node_prefs
node_export_service -->|"reads transactions"| node_tx_repo
node_export_service -->|"reads categories"| node_category_repo
node_export_service -->|"encodes CSV"| node_csv_io
node_export_service -->|"encodes XLSX"| node_xlsx_io
node_state -->|"observes preferences"| node_prefs
node_settings -.->|"updates settings"| node_state
node_theme -->|"provides palette"| node_colors
node_state -->|"computes metrics"| node_metrics
node_metrics -->|"uses definitions"| node_metric_def
node_metrics -->|"calculates from"| node_transaction
node_ledger_screen -->|"renders values"| node_metrics

click node_activity "https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/MainActivity.kt"
click node_app_ui "https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/ui/FlowtApp.kt"
click node_entry "https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/ui/entry/EntryScreen.kt"
click node_ledger_screen "https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/ui/ledger/LedgerScreen.kt"
click node_report "https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/ui/report/ReportScreen.kt"
click node_settings "https://github.com/nvm2478/flowt/tree/master/app/src/main/java/com/flowt/app/ui/settings"
click node_state "https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/ui/AppViewModel.kt"
click node_tx_repo "https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/data/TxRepository.kt"
click node_category_repo "https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/data/CategoryRepository.kt"
click node_transaction "https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/data/db/TransactionEntity.kt"
click node_category "https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/data/db/Category.kt"
click node_database "https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/data/db/FlowtDatabase.kt"
click node_import_ui "https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/ui/settings/ImportScreen.kt"
click node_import_service "https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/data/bill/ImportService.kt"
click node_bill_table "https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/data/bill/BillTable.kt"
click node_export_service "https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/data/bill/ExportService.kt"
click node_csv_io "https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/data/bill/CsvWriter.kt"
click node_xlsx_io "https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/data/bill/XlsxWriter.kt"
click node_prefs "https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/data/PrefsRepository.kt"
click node_theme "https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/ui/theme/FlowtTheme.kt"
click node_colors "https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/ui/theme/FlowtColors.kt"
click node_metrics "https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/metrics/MetricValue.kt"
click node_metric_def "https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/metrics/LedgerMetric.kt"

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_activity,node_app_ui,node_entry,node_ledger_screen,node_report,node_settings,node_state,node_user toneBlue
class node_tx_repo,node_category_repo,node_transaction,node_category,node_database toneAmber
class node_import_ui,node_import_service,node_bill_table,node_export_service,node_csv_io,node_xlsx_io toneMint
class node_metrics,node_metric_def toneRose
class node_prefs,node_theme,node_colors toneIndigo
```

## Components

### App and screens

- [Android activity](https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/MainActivity.kt): `app/src/main/java/com/flowt/app/MainActivity.kt`
- [App navigation](https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/ui/FlowtApp.kt): `app/src/main/java/com/flowt/app/ui/FlowtApp.kt`
- [Entry and edit](https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/ui/entry/EntryScreen.kt): `app/src/main/java/com/flowt/app/ui/entry/EntryScreen.kt`
- [Ledger view](https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/ui/ledger/LedgerScreen.kt): `app/src/main/java/com/flowt/app/ui/ledger/LedgerScreen.kt`
- [Reports](https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/ui/report/ReportScreen.kt): `app/src/main/java/com/flowt/app/ui/report/ReportScreen.kt`
- [Settings](https://github.com/nvm2478/flowt/tree/master/app/src/main/java/com/flowt/app/ui/settings): `app/src/main/java/com/flowt/app/ui/settings`
- [App state](https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/ui/AppViewModel.kt): `app/src/main/java/com/flowt/app/ui/AppViewModel.kt`

### Ledger data

- [Transaction repository](https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/data/TxRepository.kt): `app/src/main/java/com/flowt/app/data/TxRepository.kt`
- [Category repository](https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/data/CategoryRepository.kt): `app/src/main/java/com/flowt/app/data/CategoryRepository.kt`
- [Transactions](https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/data/db/TransactionEntity.kt): `app/src/main/java/com/flowt/app/data/db/TransactionEntity.kt`
- [Category tree](https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/data/db/Category.kt): `app/src/main/java/com/flowt/app/data/db/Category.kt`
- [Room database](https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/data/db/FlowtDatabase.kt): `app/src/main/java/com/flowt/app/data/db/FlowtDatabase.kt`

### Bill interchange

- [Import review](https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/ui/settings/ImportScreen.kt): `app/src/main/java/com/flowt/app/ui/settings/ImportScreen.kt`
- [Import planning](https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/data/bill/ImportService.kt): `app/src/main/java/com/flowt/app/data/bill/ImportService.kt`
- [Bill table parsing](https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/data/bill/BillTable.kt): `app/src/main/java/com/flowt/app/data/bill/BillTable.kt`
- [Export service](https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/data/bill/ExportService.kt): `app/src/main/java/com/flowt/app/data/bill/ExportService.kt`
- [CSV codecs](https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/data/bill/CsvWriter.kt): `app/src/main/java/com/flowt/app/data/bill/CsvWriter.kt`
- [XLSX codecs](https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/data/bill/XlsxWriter.kt): `app/src/main/java/com/flowt/app/data/bill/XlsxWriter.kt`

### Metrics

- [Metric calculations](https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/metrics/MetricValue.kt): `app/src/main/java/com/flowt/app/metrics/MetricValue.kt`
- [Metric definitions](https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/metrics/LedgerMetric.kt): `app/src/main/java/com/flowt/app/metrics/LedgerMetric.kt`

### Appearance

- [Preferences](https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/data/PrefsRepository.kt): `app/src/main/java/com/flowt/app/data/PrefsRepository.kt`
- [Theme roles](https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/ui/theme/FlowtTheme.kt): `app/src/main/java/com/flowt/app/ui/theme/FlowtTheme.kt`
- [Color palette](https://github.com/nvm2478/flowt/blob/master/app/src/main/java/com/flowt/app/ui/theme/FlowtColors.kt): `app/src/main/java/com/flowt/app/ui/theme/FlowtColors.kt`

### Other components

- **User**

## Connections

- User → Android activity: opens app (evidence: `app/src/main/java/com/flowt/app/MainActivity.kt`)
- Android activity → App navigation: sets content (evidence: `app/src/main/java/com/flowt/app/MainActivity.kt`)
- Android activity → App state: creates (evidence: `app/src/main/java/com/flowt/app/MainActivity.kt`)
- Android activity → Theme roles: applies (evidence: `app/src/main/java/com/flowt/app/MainActivity.kt`)
- User → Entry and edit: records spending
- App navigation → Entry and edit: shows (evidence: `app/src/main/java/com/flowt/app/ui/FlowtApp.kt`)
- App navigation → Ledger view: shows (evidence: `app/src/main/java/com/flowt/app/ui/FlowtApp.kt`)
- App navigation → Reports: shows (evidence: `app/src/main/java/com/flowt/app/ui/FlowtApp.kt`)
- App navigation → Settings: shows (evidence: `app/src/main/java/com/flowt/app/ui/FlowtApp.kt`)
- Entry and edit → App state: uses (evidence: `app/src/main/java/com/flowt/app/ui/entry/EntryScreen.kt`)
- App state → Transaction repository: observes and updates (evidence: `app/src/main/java/com/flowt/app/ui/AppViewModel.kt`)
- App state → Category repository: uses (evidence: `app/src/main/java/com/flowt/app/ui/AppViewModel.kt`)
- App state → Import planning: invokes (evidence: `app/src/main/java/com/flowt/app/ui/AppViewModel.kt`)
- App state → Export service: invokes (evidence: `app/src/main/java/com/flowt/app/ui/AppViewModel.kt`)
- Ledger view → App state: reads state
- Reports → App state: reads state
- Transaction repository → Room database: accesses (evidence: `app/src/main/java/com/flowt/app/data/TxRepository.kt`)
- Category repository → Room database: accesses (evidence: `app/src/main/java/com/flowt/app/data/CategoryRepository.kt`)
- Room database → Transactions: stores (evidence: `app/src/main/java/com/flowt/app/data/db/FlowtDatabase.kt`)
- Room database → Category tree: stores (evidence: `app/src/main/java/com/flowt/app/data/db/FlowtDatabase.kt`)
- Import review → App state: requests import (evidence: `app/src/main/java/com/flowt/app/ui/settings/ImportScreen.kt`)
- Import planning → Bill table parsing: parses rows (evidence: `app/src/main/java/com/flowt/app/data/bill/ImportService.kt`)
- Import planning → Category repository: loads and creates categories (evidence: `app/src/main/java/com/flowt/app/data/bill/ImportService.kt`)
- Import planning → Transaction repository: checks and inserts (evidence: `app/src/main/java/com/flowt/app/data/bill/ImportService.kt`)
- Import planning → Preferences: records imported file (evidence: `app/src/main/java/com/flowt/app/data/bill/ImportService.kt`)
- Export service → Transaction repository: reads transactions (evidence: `app/src/main/java/com/flowt/app/data/bill/ExportService.kt`)
- Export service → Category repository: reads categories (evidence: `app/src/main/java/com/flowt/app/data/bill/ExportService.kt`)
- Export service → CSV codecs: encodes CSV (evidence: `app/src/main/java/com/flowt/app/data/bill/ExportService.kt`)
- Export service → XLSX codecs: encodes XLSX (evidence: `app/src/main/java/com/flowt/app/data/bill/ExportService.kt`)
- App state → Preferences: observes preferences (evidence: `app/src/main/java/com/flowt/app/ui/AppViewModel.kt`)
- Settings → App state: updates settings (evidence: `app/src/main/java/com/flowt/app/ui/settings/ImportScreen.kt`)
- Theme roles → Color palette: provides palette (evidence: `app/src/main/java/com/flowt/app/ui/theme/FlowtColors.kt`)
- App state → Metric calculations: computes metrics (evidence: `app/src/main/java/com/flowt/app/ui/AppViewModel.kt`)
- Metric calculations → Metric definitions: uses definitions (evidence: `app/src/main/java/com/flowt/app/metrics/MetricValue.kt`)
- Metric calculations → Transactions: calculates from (evidence: `app/src/main/java/com/flowt/app/metrics/MetricValue.kt`)
- Ledger view → Metric calculations: renders values (evidence: `app/src/main/java/com/flowt/app/ui/ledger/LedgerScreen.kt`)
