# iltermon/expenselens architecture

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

## Overview

ExpenseLens is an Android personal-finance app for recording expenses and income, managing recurring transactions and financial reference data, and reviewing analytics. The main flow starts in the app’s navigation, presents transaction and management screens, passes user actions through the ViewModel and repository, and persists data in Room. Separate branches cover recurring templates, settings, localization, and the Sankey visualization library. The README is empty; links involving unsampled screens or analytics rendering are omitted or marked unverified where appropriate.

Main entry points: [`app/src/main/java/com/iltermon/expenselens/ui/ExpenseLensViewModel.kt`](https://github.com/iltermon/expenselens/blob/master/app/src/main/java/com/iltermon/expenselens/ui/ExpenseLensViewModel.kt) (Finance ViewModel), [`app/src/main/java/com/iltermon/expenselens/MainActivity.kt`](https://github.com/iltermon/expenselens/blob/master/app/src/main/java/com/iltermon/expenselens/MainActivity.kt) (Main activity), [`app/src/main/java/com/iltermon/expenselens/ui/navigation/AppNavigation.kt`](https://github.com/iltermon/expenselens/blob/master/app/src/main/java/com/iltermon/expenselens/ui/navigation/AppNavigation.kt) (App navigation), [`sankey/src/main/java/com/iltermon/sankey/SankeyDiagram.kt`](https://github.com/iltermon/expenselens/blob/master/sankey/src/main/java/com/iltermon/sankey/SankeyDiagram.kt) (Sankey diagram)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App navigation"]
  node_activity["Main activity<br/>[MainActivity.kt]"]
  node_navigation["App navigation<br/>[AppNavigation.kt]"]
  node_viewmodel["Finance ViewModel"]
  node_locale["Language preferences<br/>[LocaleManager.kt]"]
end

subgraph group_finance["Transactions and analytics"]
  node_transactions["Transaction screens"]
  node_analytics["Analytics screen<br/>[AnalyticsScreen.kt]"]
  node_templates["Recurring templates"]
end

subgraph group_management["Financial management"]
  node_settings["Settings screens"]
  node_counterparties["Accounts and categories"]
end

subgraph group_storage["Persistence"]
  node_records["Financial records"]
  node_repository["Data repository"]
  node_database[("Room database")]
end

subgraph group_visualization["Analytics visualization"]
  node_sankey["Sankey diagram<br/>[SankeyDiagram.kt]"]
  node_sankeylayout["Sankey layout<br/>[SankeyLayout.kt]"]
  node_sankeymodel["Sankey model<br/>[SankeyModel.kt]"]
end

node_user(("User"))

node_user -->|"opens app"| node_activity
node_activity -->|"applies language"| node_locale
node_activity -->|"starts navigation"| node_navigation
node_activity -->|"creates ViewModel"| node_viewmodel
node_activity -->|"opens database"| node_database
node_activity -->|"creates repository"| node_repository
node_navigation -->|"routes to"| node_transactions
node_navigation -->|"routes to"| node_analytics
node_navigation -->|"routes to"| node_templates
node_navigation -->|"routes to"| node_settings
node_transactions -->|"requests operations"| node_viewmodel
node_templates -->|"requests operations"| node_viewmodel
node_settings -->|"requests operations"| node_viewmodel
node_viewmodel -->|"reads and writes"| node_repository
node_repository -->|"accesses DAOs"| node_database
node_database -->|"stores entities"| node_records
node_viewmodel -->|"builds transactions"| node_records
node_viewmodel -.->|"supplies analytics state"| node_analytics
node_analytics -.->|"may render flows"| node_sankey
node_sankey -->|"uses layout"| node_sankeylayout
node_sankey -->|"consumes model"| node_sankeymodel

click node_activity "https://github.com/iltermon/expenselens/blob/master/app/src/main/java/com/iltermon/expenselens/MainActivity.kt"
click node_navigation "https://github.com/iltermon/expenselens/blob/master/app/src/main/java/com/iltermon/expenselens/ui/navigation/AppNavigation.kt"
click node_viewmodel "https://github.com/iltermon/expenselens/blob/master/app/src/main/java/com/iltermon/expenselens/ui/ExpenseLensViewModel.kt"
click node_transactions "https://github.com/iltermon/expenselens/tree/master/app/src/main/java/com/iltermon/expenselens/ui/transactions"
click node_analytics "https://github.com/iltermon/expenselens/blob/master/app/src/main/java/com/iltermon/expenselens/ui/analytics/AnalyticsScreen.kt"
click node_templates "https://github.com/iltermon/expenselens/tree/master/app/src/main/java/com/iltermon/expenselens/ui/templates"
click node_records "https://github.com/iltermon/expenselens/tree/master/app/src/main/java/com/iltermon/expenselens/data"
click node_repository "https://github.com/iltermon/expenselens/blob/master/app/src/main/java/com/iltermon/expenselens/data/ExpenseLensRepository.kt"
click node_database "https://github.com/iltermon/expenselens/blob/master/app/src/main/java/com/iltermon/expenselens/data/ExpenseLensDatabase.kt"
click node_settings "https://github.com/iltermon/expenselens/tree/master/app/src/main/java/com/iltermon/expenselens/ui/settings"
click node_counterparties "https://github.com/iltermon/expenselens/tree/master/app/src/main/java/com/iltermon/expenselens/data"
click node_locale "https://github.com/iltermon/expenselens/blob/master/app/src/main/java/com/iltermon/expenselens/ui/util/LocaleManager.kt"
click node_sankey "https://github.com/iltermon/expenselens/blob/master/sankey/src/main/java/com/iltermon/sankey/SankeyDiagram.kt"
click node_sankeylayout "https://github.com/iltermon/expenselens/blob/master/sankey/src/main/java/com/iltermon/sankey/SankeyLayout.kt"
click node_sankeymodel "https://github.com/iltermon/expenselens/blob/master/sankey/src/main/java/com/iltermon/sankey/SankeyModel.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_locale,node_user toneBlue
class node_transactions,node_analytics,node_templates toneAmber
class node_settings,node_counterparties toneMint
class node_records,node_repository,node_database toneRose
class node_sankey,node_sankeylayout,node_sankeymodel toneIndigo
```

## Components

### App navigation

- [Main activity](https://github.com/iltermon/expenselens/blob/master/app/src/main/java/com/iltermon/expenselens/MainActivity.kt): `app/src/main/java/com/iltermon/expenselens/MainActivity.kt`
- [App navigation](https://github.com/iltermon/expenselens/blob/master/app/src/main/java/com/iltermon/expenselens/ui/navigation/AppNavigation.kt): `app/src/main/java/com/iltermon/expenselens/ui/navigation/AppNavigation.kt`
- [Finance ViewModel](https://github.com/iltermon/expenselens/blob/master/app/src/main/java/com/iltermon/expenselens/ui/ExpenseLensViewModel.kt): `app/src/main/java/com/iltermon/expenselens/ui/ExpenseLensViewModel.kt`
- [Language preferences](https://github.com/iltermon/expenselens/blob/master/app/src/main/java/com/iltermon/expenselens/ui/util/LocaleManager.kt): `app/src/main/java/com/iltermon/expenselens/ui/util/LocaleManager.kt`

### Transactions and analytics

- [Transaction screens](https://github.com/iltermon/expenselens/tree/master/app/src/main/java/com/iltermon/expenselens/ui/transactions): `app/src/main/java/com/iltermon/expenselens/ui/transactions`
- [Analytics screen](https://github.com/iltermon/expenselens/blob/master/app/src/main/java/com/iltermon/expenselens/ui/analytics/AnalyticsScreen.kt): `app/src/main/java/com/iltermon/expenselens/ui/analytics/AnalyticsScreen.kt`
- [Recurring templates](https://github.com/iltermon/expenselens/tree/master/app/src/main/java/com/iltermon/expenselens/ui/templates): `app/src/main/java/com/iltermon/expenselens/ui/templates`

### Financial management

- [Settings screens](https://github.com/iltermon/expenselens/tree/master/app/src/main/java/com/iltermon/expenselens/ui/settings): `app/src/main/java/com/iltermon/expenselens/ui/settings`
- [Accounts and categories](https://github.com/iltermon/expenselens/tree/master/app/src/main/java/com/iltermon/expenselens/data): `app/src/main/java/com/iltermon/expenselens/data`

### Persistence

- [Financial records](https://github.com/iltermon/expenselens/tree/master/app/src/main/java/com/iltermon/expenselens/data): `app/src/main/java/com/iltermon/expenselens/data`
- [Data repository](https://github.com/iltermon/expenselens/blob/master/app/src/main/java/com/iltermon/expenselens/data/ExpenseLensRepository.kt): `app/src/main/java/com/iltermon/expenselens/data/ExpenseLensRepository.kt`
- [Room database](https://github.com/iltermon/expenselens/blob/master/app/src/main/java/com/iltermon/expenselens/data/ExpenseLensDatabase.kt): `app/src/main/java/com/iltermon/expenselens/data/ExpenseLensDatabase.kt`

### Analytics visualization

- [Sankey diagram](https://github.com/iltermon/expenselens/blob/master/sankey/src/main/java/com/iltermon/sankey/SankeyDiagram.kt): `sankey/src/main/java/com/iltermon/sankey/SankeyDiagram.kt`
- [Sankey layout](https://github.com/iltermon/expenselens/blob/master/sankey/src/main/java/com/iltermon/sankey/SankeyLayout.kt): `sankey/src/main/java/com/iltermon/sankey/SankeyLayout.kt`
- [Sankey model](https://github.com/iltermon/expenselens/blob/master/sankey/src/main/java/com/iltermon/sankey/SankeyModel.kt): `sankey/src/main/java/com/iltermon/sankey/SankeyModel.kt`

### Other components

- **User**

## Connections

- User → Main activity: opens app
- Main activity → Language preferences: applies language (evidence: `app/src/main/java/com/iltermon/expenselens/MainActivity.kt`)
- Main activity → App navigation: starts navigation (evidence: `app/src/main/java/com/iltermon/expenselens/MainActivity.kt`)
- Main activity → Finance ViewModel: creates ViewModel (evidence: `app/src/main/java/com/iltermon/expenselens/MainActivity.kt`)
- Main activity → Room database: opens database (evidence: `app/src/main/java/com/iltermon/expenselens/MainActivity.kt`)
- Main activity → Data repository: creates repository (evidence: `app/src/main/java/com/iltermon/expenselens/MainActivity.kt`)
- App navigation → Transaction screens: routes to (evidence: `app/src/main/java/com/iltermon/expenselens/ui/navigation/AppNavigation.kt`)
- App navigation → Analytics screen: routes to (evidence: `app/src/main/java/com/iltermon/expenselens/ui/navigation/AppNavigation.kt`)
- App navigation → Recurring templates: routes to (evidence: `app/src/main/java/com/iltermon/expenselens/ui/navigation/AppNavigation.kt`)
- App navigation → Settings screens: routes to (evidence: `app/src/main/java/com/iltermon/expenselens/ui/navigation/AppNavigation.kt`)
- Transaction screens → Finance ViewModel: requests operations (evidence: `app/src/main/java/com/iltermon/expenselens/ui/transactions/ExpensesScreen.kt`)
- Recurring templates → Finance ViewModel: requests operations (evidence: `app/src/main/java/com/iltermon/expenselens/ui/templates/TemplatesScreen.kt`)
- Settings screens → Finance ViewModel: requests operations (evidence: `app/src/main/java/com/iltermon/expenselens/ui/settings/AccountsScreen.kt`)
- Finance ViewModel → Data repository: reads and writes (evidence: `app/src/main/java/com/iltermon/expenselens/ui/ExpenseLensViewModel.kt`)
- Data repository → Room database: accesses DAOs (evidence: `app/src/main/java/com/iltermon/expenselens/data/ExpenseLensRepository.kt`)
- Room database → Financial records: stores entities (evidence: `app/src/main/java/com/iltermon/expenselens/data/ExpenseLensDatabase.kt`)
- Finance ViewModel → Financial records: builds transactions (evidence: `app/src/main/java/com/iltermon/expenselens/ui/ExpenseLensViewModel.kt`)
- Finance ViewModel → Analytics screen: supplies analytics state
- Analytics screen → Sankey diagram: may render flows
- Sankey diagram → Sankey layout: uses layout (evidence: `sankey/src/main/java/com/iltermon/sankey/SankeyDiagram.kt`)
- Sankey diagram → Sankey model: consumes model (evidence: `sankey/src/main/java/com/iltermon/sankey/SankeyDiagram.kt`)
