# itznan/stash architecture

> Architecture diagram of the GitHub repository itznan/stash, 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/itznan/stash
- Repository: https://github.com/itznan/stash

## Overview

Stash is an offline Android finance and debt tracker. Users enter income, spending, transfers, or loans through Compose screens; the activity presents those workflows, while a ViewModel coordinates finance state and local persistence. The app also provides history, tags, settings, loan repayment management, and export/backup and biometric-lock capabilities. Edges follow excerpted calls or source-index references; unsampled implementations are represented only where the tree supports a path, and unverified wiring is omitted.

Main entry points: [`app/src/main/java/com/nan/stash/MainActivity.kt`](https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/MainActivity.kt) (Activity shell), [`app/src/main/java/com/nan/stash/ui/MainViewModel.kt`](https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/ui/MainViewModel.kt) (Finance state), [`app/src/main/java/com/nan/stash/data/local/AppDatabase.kt`](https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/data/local/AppDatabase.kt) (Room database), [`app/src/main/java/com/nan/stash/ui/screens/SettingsScreen.kt`](https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/ui/screens/SettingsScreen.kt) (Settings screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App shell"]
  node_activity["Activity shell<br/>[MainActivity.kt]"]
  node_navigation["Navigation<br/>[BottomNavBar.kt]"]
  node_viewmodel["Finance state<br/>[MainViewModel.kt]"]
end

subgraph group_finance["Finance workflows"]
  node_home["Finance overview<br/>[HomeScreen.kt]"]
  node_history["Transaction history<br/>[HistoryScreen.kt]"]
  node_tags["Tag analytics<br/>[TagsScreen.kt]"]
  node_money_entry["Money entry"]
  node_transfer["Wallet transfer"]
  node_edit_transaction["Transaction editing"]
end

subgraph group_debt["Debt tracking"]
  node_loan_entry["Loan entry"]
  node_loan_manager["Loan management"]
end

subgraph group_storage["Local data"]
  node_database[("Room database<br/>[AppDatabase.kt]")]
  node_transactions["Transaction records"]
  node_loans["Loan records<br/>[LoanEntity.kt]"]
end

subgraph group_preferences["Settings and security"]
  node_settings[("Preferences store")]
  node_settings_screen["Settings screen<br/>[SettingsScreen.kt]"]
end

node_user(("User"))

node_user -->|"opens"| node_activity
node_activity -->|"shows"| node_navigation
node_activity -->|"observes and invokes"| node_viewmodel
node_activity -->|"routes to"| node_home
node_activity -->|"routes to"| node_history
node_activity -->|"routes to"| node_tags
node_activity -->|"routes to"| node_settings_screen
node_activity -->|"opens"| node_money_entry
node_activity -->|"opens"| node_transfer
node_activity -->|"opens"| node_edit_transaction
node_activity -->|"opens"| node_loan_entry
node_activity -->|"opens"| node_loan_manager
node_settings_screen -->|"changes preferences"| node_viewmodel
node_viewmodel -->|"uses"| node_database
node_viewmodel -->|"reads and updates"| node_settings
node_database -->|"stores"| node_transactions
node_database -->|"stores"| node_loans

click node_activity "https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/MainActivity.kt"
click node_navigation "https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/ui/navigation/BottomNavBar.kt"
click node_home "https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/ui/screens/HomeScreen.kt"
click node_history "https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/ui/screens/HistoryScreen.kt"
click node_tags "https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/ui/screens/TagsScreen.kt"
click node_money_entry "https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/ui/screens/SpendMoneyBottomSheet.kt"
click node_transfer "https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/ui/screens/TransferMoneyBottomSheet.kt"
click node_edit_transaction "https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/ui/screens/EditTransactionBottomSheet.kt"
click node_loan_entry "https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/ui/screens/LendMoneyBottomSheet.kt"
click node_loan_manager "https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/ui/screens/LentMoneyManagerSheet.kt"
click node_viewmodel "https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/ui/MainViewModel.kt"
click node_database "https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/data/local/AppDatabase.kt"
click node_transactions "https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/data/local/TransactionEntity.kt"
click node_loans "https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/data/local/LoanEntity.kt"
click node_settings "https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/data/local/SettingsDataStore.kt"
click node_settings_screen "https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/ui/screens/SettingsScreen.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_navigation,node_viewmodel,node_user toneBlue
class node_home,node_history,node_tags,node_money_entry,node_transfer,node_edit_transaction toneAmber
class node_loan_entry,node_loan_manager toneMint
class node_database,node_transactions,node_loans toneRose
class node_settings,node_settings_screen toneIndigo
```

## Components

### App shell

- [Activity shell](https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/MainActivity.kt): `app/src/main/java/com/nan/stash/MainActivity.kt`
- [Navigation](https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/ui/navigation/BottomNavBar.kt): `app/src/main/java/com/nan/stash/ui/navigation/BottomNavBar.kt`
- [Finance state](https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/ui/MainViewModel.kt): `app/src/main/java/com/nan/stash/ui/MainViewModel.kt`

### Finance workflows

- [Finance overview](https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/ui/screens/HomeScreen.kt): `app/src/main/java/com/nan/stash/ui/screens/HomeScreen.kt`
- [Transaction history](https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/ui/screens/HistoryScreen.kt): `app/src/main/java/com/nan/stash/ui/screens/HistoryScreen.kt`
- [Tag analytics](https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/ui/screens/TagsScreen.kt): `app/src/main/java/com/nan/stash/ui/screens/TagsScreen.kt`
- [Money entry](https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/ui/screens/SpendMoneyBottomSheet.kt): `app/src/main/java/com/nan/stash/ui/screens/SpendMoneyBottomSheet.kt`
- [Wallet transfer](https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/ui/screens/TransferMoneyBottomSheet.kt): `app/src/main/java/com/nan/stash/ui/screens/TransferMoneyBottomSheet.kt`
- [Transaction editing](https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/ui/screens/EditTransactionBottomSheet.kt): `app/src/main/java/com/nan/stash/ui/screens/EditTransactionBottomSheet.kt`

### Debt tracking

- [Loan entry](https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/ui/screens/LendMoneyBottomSheet.kt): `app/src/main/java/com/nan/stash/ui/screens/LendMoneyBottomSheet.kt`
- [Loan management](https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/ui/screens/LentMoneyManagerSheet.kt): `app/src/main/java/com/nan/stash/ui/screens/LentMoneyManagerSheet.kt`

### Local data

- [Room database](https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/data/local/AppDatabase.kt): `app/src/main/java/com/nan/stash/data/local/AppDatabase.kt`
- [Transaction records](https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/data/local/TransactionEntity.kt): `app/src/main/java/com/nan/stash/data/local/TransactionEntity.kt`
- [Loan records](https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/data/local/LoanEntity.kt): `app/src/main/java/com/nan/stash/data/local/LoanEntity.kt`

### Settings and security

- [Preferences store](https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/data/local/SettingsDataStore.kt): `app/src/main/java/com/nan/stash/data/local/SettingsDataStore.kt`
- [Settings screen](https://github.com/itznan/stash/blob/main/app/src/main/java/com/nan/stash/ui/screens/SettingsScreen.kt): `app/src/main/java/com/nan/stash/ui/screens/SettingsScreen.kt`

### Other components

- **User**

## Connections

- User → Activity shell: opens
- Activity shell → Navigation: shows (evidence: `app/src/main/java/com/nan/stash/MainActivity.kt`)
- Activity shell → Finance state: observes and invokes (evidence: `app/src/main/java/com/nan/stash/MainActivity.kt`)
- Activity shell → Finance overview: routes to (evidence: `app/src/main/java/com/nan/stash/MainActivity.kt`)
- Activity shell → Transaction history: routes to (evidence: `app/src/main/java/com/nan/stash/MainActivity.kt`)
- Activity shell → Tag analytics: routes to (evidence: `app/src/main/java/com/nan/stash/MainActivity.kt`)
- Activity shell → Settings screen: routes to (evidence: `app/src/main/java/com/nan/stash/MainActivity.kt`)
- Activity shell → Money entry: opens (evidence: `app/src/main/java/com/nan/stash/MainActivity.kt`)
- Activity shell → Wallet transfer: opens (evidence: `app/src/main/java/com/nan/stash/MainActivity.kt`)
- Activity shell → Transaction editing: opens (evidence: `app/src/main/java/com/nan/stash/MainActivity.kt`)
- Activity shell → Loan entry: opens (evidence: `app/src/main/java/com/nan/stash/MainActivity.kt`)
- Activity shell → Loan management: opens (evidence: `app/src/main/java/com/nan/stash/MainActivity.kt`)
- Settings screen → Finance state: changes preferences (evidence: `app/src/main/java/com/nan/stash/MainActivity.kt`)
- Finance state → Room database: uses (evidence: `app/src/main/java/com/nan/stash/ui/MainViewModel.kt`)
- Finance state → Preferences store: reads and updates (evidence: `app/src/main/java/com/nan/stash/ui/MainViewModel.kt`)
- Room database → Transaction records: stores (evidence: `app/src/main/java/com/nan/stash/data/local/AppDatabase.kt`)
- Room database → Loan records: stores (evidence: `app/src/main/java/com/nan/stash/data/local/AppDatabase.kt`)
