# karunnagaraj/financetracker architecture

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

- Interactive diagram: https://gitdiagram.com/karunnagaraj/financetracker
- Repository: https://github.com/karunnagaraj/financetracker

## Overview

This is an Android personal finance tracker. The tree suggests a user journey from the app entry point into dashboard, transaction, insight, and settings screens; transactions can be captured from SMS or imported from CSV, then categorized and stored. Dashboard and insights provide different views of tracked spending. The supplied README is empty and no runtime source files were excerpted, so the components and feature areas below are identified from filenames; unverified runtime relationships are shown as dashed edges without evidence paths.

Main entry points: [`app/src/main/java/com/example/financetracker/MainScreen.kt`](https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/MainScreen.kt) (Main screen), [`app/src/main/java/com/example/financetracker/data/repository/TransactionRepository.kt`](https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/data/repository/TransactionRepository.kt) (Transaction repository), [`app/src/main/java/com/example/financetracker/data/AppDatabase.kt`](https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/data/AppDatabase.kt) (Room database), [`app/src/main/java/com/example/financetracker/ui/screens/transactions/TransactionsScreen.kt`](https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/ui/screens/transactions/TransactionsScreen.kt) (Transaction list)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and Navigation"]
  node_main_activity["Activity entry<br/>[MainActivity.kt]"]
  node_main_screen["Main screen<br/>[MainScreen.kt]"]
  node_navigation["Screen routes<br/>[Screen.kt]"]
end

subgraph group_finance["Finance Views"]
  node_dashboard["Dashboard<br/>[DashboardScreen.kt]"]
  node_dashboard_vm["Dashboard state"]
  node_insights["Spending insights<br/>[InsightsScreen.kt]"]
  node_transactions["Transaction list"]
  node_transactions_vm["Transaction state"]
  node_categorize["Categorization sheet"]
  node_settings["Settings and import<br/>[SettingsScreen.kt]"]
end

subgraph group_storage["Transaction Storage"]
  node_repository["Transaction repository"]
  node_database[("Room database<br/>[AppDatabase.kt]")]
  node_transaction_dao["Transaction DAO<br/>[TransactionDAO.kt]"]
  node_category_dao["Category DAO"]
  node_merchant_dao["Merchant rule DAO<br/>[MerchantRuleDAO.kt]"]
  node_entities["Finance entities"]
end

subgraph group_capture["Transaction Capture"]
  node_sms_receiver["SMS receiver<br/>[SmsReceiver.kt]"]
  node_sms_parser["SMS parser<br/>[SmsParser.kt]"]
  node_classifier["Transaction classifier"]
  node_csv_importer["CSV importer<br/>[CsvImporter.kt]"]
end

node_user(("Finance user"))
node_sms_service(("SMS source"))
node_csv_file["CSV file"]

node_user -.->|"opens"| node_main_activity
node_main_activity -.->|"launches"| node_main_screen
node_main_screen -.->|"routes via"| node_navigation
node_main_screen -.->|"shows"| node_dashboard
node_main_screen -.->|"shows"| node_insights
node_main_screen -.->|"shows"| node_transactions
node_main_screen -.->|"shows"| node_settings
node_dashboard -.->|"uses state"| node_dashboard_vm
node_dashboard_vm -.->|"requests data"| node_repository
node_transactions -.->|"uses state"| node_transactions_vm
node_transactions -.->|"offers categorization"| node_categorize
node_transactions_vm -.->|"requests data"| node_repository
node_settings -.->|"imports CSV"| node_csv_importer
node_sms_service -.->|"delivers messages"| node_sms_receiver
node_sms_receiver -.->|"forwards message"| node_sms_parser
node_sms_parser -.->|"classifies parsed data"| node_classifier
node_csv_file -.->|"provides rows"| node_csv_importer
node_classifier -.->|"submits transaction"| node_repository
node_csv_importer -.->|"submits transactions"| node_repository
node_repository -.->|"accesses transactions"| node_transaction_dao
node_transaction_dao -.->|"queries"| node_database
node_category_dao -.->|"queries"| node_database
node_merchant_dao -.->|"queries"| node_database
node_database -.->|"stores records"| node_entities

click node_main_activity "https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/MainActivity.kt"
click node_main_screen "https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/MainScreen.kt"
click node_navigation "https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/navigation/Screen.kt"
click node_dashboard "https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/ui/screens/dashboard/DashboardScreen.kt"
click node_dashboard_vm "https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/ui/viewmodels/DashboardViewModel.kt"
click node_insights "https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/ui/screens/insights/InsightsScreen.kt"
click node_transactions "https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/ui/screens/transactions/TransactionsScreen.kt"
click node_transactions_vm "https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/ui/viewmodels/TransactionsViewModel.kt"
click node_categorize "https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/ui/screens/transactions/components/CategorizeBottomSheet.kt"
click node_settings "https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/ui/screens/settings/SettingsScreen.kt"
click node_repository "https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/data/repository/TransactionRepository.kt"
click node_database "https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/data/AppDatabase.kt"
click node_transaction_dao "https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/data/dao/TransactionDAO.kt"
click node_category_dao "https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/data/dao/CustomCategoryDAO.kt"
click node_merchant_dao "https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/data/dao/MerchantRuleDAO.kt"
click node_entities "https://github.com/karunnagaraj/financetracker/tree/master/app/src/main/java/com/example/financetracker/data/entity"
click node_sms_receiver "https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/utils/SmsReceiver.kt"
click node_sms_parser "https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/utils/SmsParser.kt"
click node_classifier "https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/utils/TransactionClassifier.kt"
click node_csv_importer "https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/utils/CsvImporter.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_main_activity,node_main_screen,node_navigation,node_user toneBlue
class node_dashboard,node_dashboard_vm,node_insights,node_transactions,node_transactions_vm,node_categorize,node_settings toneAmber
class node_repository,node_database,node_transaction_dao,node_category_dao,node_merchant_dao,node_entities toneMint
class node_sms_receiver,node_sms_parser,node_classifier,node_csv_importer toneRose
class node_sms_service,node_csv_file toneIndigo
```

## Components

### App and Navigation

- [Activity entry](https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/MainActivity.kt): `app/src/main/java/com/example/financetracker/MainActivity.kt`
- [Main screen](https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/MainScreen.kt): `app/src/main/java/com/example/financetracker/MainScreen.kt`
- [Screen routes](https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/navigation/Screen.kt): `app/src/main/java/com/example/financetracker/navigation/Screen.kt`

### Finance Views

- [Dashboard](https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/ui/screens/dashboard/DashboardScreen.kt): `app/src/main/java/com/example/financetracker/ui/screens/dashboard/DashboardScreen.kt`
- [Dashboard state](https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/ui/viewmodels/DashboardViewModel.kt): `app/src/main/java/com/example/financetracker/ui/viewmodels/DashboardViewModel.kt`
- [Spending insights](https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/ui/screens/insights/InsightsScreen.kt): `app/src/main/java/com/example/financetracker/ui/screens/insights/InsightsScreen.kt`
- [Transaction list](https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/ui/screens/transactions/TransactionsScreen.kt): `app/src/main/java/com/example/financetracker/ui/screens/transactions/TransactionsScreen.kt`
- [Transaction state](https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/ui/viewmodels/TransactionsViewModel.kt): `app/src/main/java/com/example/financetracker/ui/viewmodels/TransactionsViewModel.kt`
- [Categorization sheet](https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/ui/screens/transactions/components/CategorizeBottomSheet.kt): `app/src/main/java/com/example/financetracker/ui/screens/transactions/components/CategorizeBottomSheet.kt`
- [Settings and import](https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/ui/screens/settings/SettingsScreen.kt): `app/src/main/java/com/example/financetracker/ui/screens/settings/SettingsScreen.kt`

### Transaction Storage

- [Transaction repository](https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/data/repository/TransactionRepository.kt): `app/src/main/java/com/example/financetracker/data/repository/TransactionRepository.kt`
- [Room database](https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/data/AppDatabase.kt): `app/src/main/java/com/example/financetracker/data/AppDatabase.kt`
- [Transaction DAO](https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/data/dao/TransactionDAO.kt): `app/src/main/java/com/example/financetracker/data/dao/TransactionDAO.kt`
- [Category DAO](https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/data/dao/CustomCategoryDAO.kt): `app/src/main/java/com/example/financetracker/data/dao/CustomCategoryDAO.kt`
- [Merchant rule DAO](https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/data/dao/MerchantRuleDAO.kt): `app/src/main/java/com/example/financetracker/data/dao/MerchantRuleDAO.kt`
- [Finance entities](https://github.com/karunnagaraj/financetracker/tree/master/app/src/main/java/com/example/financetracker/data/entity): `app/src/main/java/com/example/financetracker/data/entity`

### Transaction Capture

- [SMS receiver](https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/utils/SmsReceiver.kt): `app/src/main/java/com/example/financetracker/utils/SmsReceiver.kt`
- [SMS parser](https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/utils/SmsParser.kt): `app/src/main/java/com/example/financetracker/utils/SmsParser.kt`
- [Transaction classifier](https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/utils/TransactionClassifier.kt): `app/src/main/java/com/example/financetracker/utils/TransactionClassifier.kt`
- [CSV importer](https://github.com/karunnagaraj/financetracker/blob/master/app/src/main/java/com/example/financetracker/utils/CsvImporter.kt): `app/src/main/java/com/example/financetracker/utils/CsvImporter.kt`

### Other components

- **Finance user**
- **SMS source**
- **CSV file**

## Connections

- Finance user → Activity entry: opens
- Activity entry → Main screen: launches
- Main screen → Screen routes: routes via
- Main screen → Dashboard: shows
- Main screen → Spending insights: shows
- Main screen → Transaction list: shows
- Main screen → Settings and import: shows
- Dashboard → Dashboard state: uses state
- Dashboard state → Transaction repository: requests data
- Transaction list → Transaction state: uses state
- Transaction list → Categorization sheet: offers categorization
- Transaction state → Transaction repository: requests data
- Settings and import → CSV importer: imports CSV
- SMS source → SMS receiver: delivers messages
- SMS receiver → SMS parser: forwards message
- SMS parser → Transaction classifier: classifies parsed data
- CSV file → CSV importer: provides rows
- Transaction classifier → Transaction repository: submits transaction
- CSV importer → Transaction repository: submits transactions
- Transaction repository → Transaction DAO: accesses transactions
- Transaction DAO → Room database: queries
- Category DAO → Room database: queries
- Merchant rule DAO → Room database: queries
- Room database → Finance entities: stores records
