How iltermon/expenselens works
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: ExpenseLensViewModel.kt Finance ViewModel · MainActivity.kt Main activity · AppNavigation.kt App navigation · SankeyDiagram.kt Sankey diagram
Components 16
App navigation
- Main activity
app/src/main/java/com/iltermon/expenselens/MainActivity.kt - App navigation
app/src/main/java/com/iltermon/expenselens/ui/navigation/AppNavigation.kt - Finance ViewModel
app/src/main/java/com/iltermon/expenselens/ui/ExpenseLensViewModel.kt - Language preferences
app/src/main/java/com/iltermon/expenselens/ui/util/LocaleManager.kt
Transactions and analytics
- Transaction screens
app/src/main/java/com/iltermon/expenselens/ui/transactions - Analytics screen
app/src/main/java/com/iltermon/expenselens/ui/analytics/AnalyticsScreen.kt - Recurring templates
app/src/main/java/com/iltermon/expenselens/ui/templates
Financial management
- Settings screens
app/src/main/java/com/iltermon/expenselens/ui/settings - Accounts and categories
app/src/main/java/com/iltermon/expenselens/data
Persistence
- Financial records
app/src/main/java/com/iltermon/expenselens/data - Data repository
app/src/main/java/com/iltermon/expenselens/data/ExpenseLensRepository.kt - Room database
app/src/main/java/com/iltermon/expenselens/data/ExpenseLensDatabase.kt
Analytics visualization
- Sankey diagram
sankey/src/main/java/com/iltermon/sankey/SankeyDiagram.kt - Sankey layout
sankey/src/main/java/com/iltermon/sankey/SankeyLayout.kt - Sankey model
sankey/src/main/java/com/iltermon/sankey/SankeyModel.kt
Other components
- User
Connections 21
- User → Main activity: opens app
- Main activity → Language preferences: applies language
app/src/main/java/com/iltermon/expenselens/MainActivity.kt - Main activity → App navigation: starts navigation
app/src/main/java/com/iltermon/expenselens/MainActivity.kt - Main activity → Finance ViewModel: creates ViewModel
app/src/main/java/com/iltermon/expenselens/MainActivity.kt - Main activity → Room database: opens database
app/src/main/java/com/iltermon/expenselens/MainActivity.kt - Main activity → Data repository: creates repository
app/src/main/java/com/iltermon/expenselens/MainActivity.kt - App navigation → Transaction screens: routes to
app/src/main/java/com/iltermon/expenselens/ui/navigation/AppNavigation.kt - App navigation → Analytics screen: routes to
app/src/main/java/com/iltermon/expenselens/ui/navigation/AppNavigation.kt - App navigation → Recurring templates: routes to
app/src/main/java/com/iltermon/expenselens/ui/navigation/AppNavigation.kt - App navigation → Settings screens: routes to
app/src/main/java/com/iltermon/expenselens/ui/navigation/AppNavigation.kt - Transaction screens → Finance ViewModel: requests operations
app/src/main/java/com/iltermon/expenselens/ui/transactions/ExpensesScreen.kt - Recurring templates → Finance ViewModel: requests operations
app/src/main/java/com/iltermon/expenselens/ui/templates/TemplatesScreen.kt - Settings screens → Finance ViewModel: requests operations
app/src/main/java/com/iltermon/expenselens/ui/settings/AccountsScreen.kt - Finance ViewModel → Data repository: reads and writes
app/src/main/java/com/iltermon/expenselens/ui/ExpenseLensViewModel.kt - Data repository → Room database: accesses DAOs
app/src/main/java/com/iltermon/expenselens/data/ExpenseLensRepository.kt - Room database → Financial records: stores entities
app/src/main/java/com/iltermon/expenselens/data/ExpenseLensDatabase.kt - Finance ViewModel → Financial records: builds transactions
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
sankey/src/main/java/com/iltermon/sankey/SankeyDiagram.kt - Sankey diagram → Sankey model: consumes model
sankey/src/main/java/com/iltermon/sankey/SankeyDiagram.kt