# nhingyen/crypto-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/nhingyen/crypto-tracker
- Repository: https://github.com/nhingyen/crypto-tracker

## Overview

CryptoTracker is a native Android cryptocurrency tracker. The main workflow is to browse and filter a live or cached market, open a coin’s detail, and optionally save it or configure a price alert; settings control display currency and theme. Compose screens and ViewModels lead into repositories, which use public APIs, Room, and DataStore. WorkManager checks enabled alerts and the notifier posts Android notifications. Some feature wiring is documented in the README or named in the source index; unsampled implementation details are not inferred.

Main entry points: [`app/src/main/java/com/ngyennhi/cryptotracker/ui/navigation/CryptoTrackerApp.kt`](https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/ui/navigation/CryptoTrackerApp.kt) (Compose navigation), [`app/src/main/java/com/ngyennhi/cryptotracker/alerts/PriceAlertWorker.kt`](https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/alerts/PriceAlertWorker.kt) (Alert worker), [`app/src/main/java/com/ngyennhi/cryptotracker/data/repository/CoinDetailRepository.kt`](https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/data/repository/CoinDetailRepository.kt) (Detail repository), [`app/src/main/java/com/ngyennhi/cryptotracker/data/repository/MarketRepository.kt`](https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/data/repository/MarketRepository.kt) (Market repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and navigation"]
  node_activity["Main activity<br/>[MainActivity.kt]"]
  node_navigation["Compose navigation"]
end

subgraph group_market["Market and coin data"]
  node_marketui["Market screen<br/>[MarketScreen.kt]"]
  node_marketvm["Market ViewModel<br/>[MarketViewModel.kt]"]
  node_marketrepo["Market repository"]
  node_coinlore["CoinLore API<br/>[CoinLoreApi.kt]"]
  node_marketcache[("Market cache<br/>[MarketCacheDao.kt]")]
  node_detailui["Coin detail screen"]
  node_detailrepo["Detail repository"]
  node_gecko["CoinGecko API<br/>[CoinGeckoApi.kt]"]
end

subgraph group_preferences["Preferences and favorites"]
  node_exchange["Exchange-rate API<br/>[ExchangeRateApi.kt]"]
  node_favoritesui["Favorites screen<br/>[FavoritesScreen.kt]"]
  node_favoritesrepo["Favorites repository"]
  node_favoritesdb[("Favorites database")]
  node_settingsui["Settings screen<br/>[SettingsScreen.kt]"]
  node_currencyrepo[("Currency preferences")]
  node_themerepo[("Theme preferences")]
end

subgraph group_alerts["Price alerts"]
  node_alertsui["Alert controls"]
  node_alertsrepo["Alerts repository"]
  node_alertsdb[("Alerts database")]
  node_scheduler["Alert scheduler"]
  node_worker["Alert worker"]
  node_notifier["Notification delivery"]
end

node_user(("App user"))
node_android(("Android notifications"))

node_user -->|"opens app"| node_activity
node_activity -->|"launches"| node_navigation
node_navigation -->|"routes to"| node_marketui
node_navigation -->|"routes to"| node_detailui
node_navigation -->|"routes to"| node_favoritesui
node_navigation -->|"shows"| node_settingsui
node_marketui -->|"uses state"| node_marketvm
node_marketvm -->|"loads market"| node_marketrepo
node_marketrepo -->|"fetches data"| node_coinlore
node_marketrepo -->|"reads and writes"| node_marketcache
node_detailui -->|"loads detail"| node_detailrepo
node_detailrepo -->|"fetches detail"| node_coinlore
node_detailrepo -.->|"enriches detail"| node_gecko
node_detailui -->|"edits alerts"| node_alertsrepo
node_favoritesui -->|"reads favorites"| node_favoritesrepo
node_favoritesrepo -->|"persists locally"| node_favoritesdb
node_settingsui -->|"sets currency"| node_currencyrepo
node_settingsui -->|"sets theme"| node_themerepo
node_currencyrepo -.->|"gets conversion rate"| node_exchange
node_alertsrepo -->|"stores alerts"| node_alertsdb
node_alertsrepo -->|"schedules checks"| node_scheduler
node_scheduler -->|"enqueues work"| node_worker
node_worker -->|"reads and updates"| node_alertsdb
node_worker -->|"loads current price"| node_detailrepo
node_worker -->|"posts triggered alert"| node_notifier
node_notifier -->|"posts notification"| node_android

click node_activity "https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/MainActivity.kt"
click node_navigation "https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/ui/navigation/CryptoTrackerApp.kt"
click node_marketui "https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/ui/market/MarketScreen.kt"
click node_marketvm "https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/ui/market/MarketViewModel.kt"
click node_marketrepo "https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/data/repository/MarketRepository.kt"
click node_coinlore "https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/data/remote/CoinLoreApi.kt"
click node_marketcache "https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/data/local/MarketCacheDao.kt"
click node_detailui "https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/ui/detail/CoinDetailScreen.kt"
click node_detailrepo "https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/data/repository/CoinDetailRepository.kt"
click node_gecko "https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/data/remote/CoinGeckoApi.kt"
click node_exchange "https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/data/remote/ExchangeRateApi.kt"
click node_favoritesui "https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/ui/favorites/FavoritesScreen.kt"
click node_favoritesrepo "https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/data/repository/FavoritesRepository.kt"
click node_favoritesdb "https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/data/local/FavoritesDatabase.kt"
click node_settingsui "https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/ui/settings/SettingsScreen.kt"
click node_currencyrepo "https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/data/repository/CurrencyPreferencesRepository.kt"
click node_themerepo "https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/data/repository/ThemePreferencesRepository.kt"
click node_alertsui "https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/ui/detail/CoinDetailScreen.kt"
click node_alertsrepo "https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/data/repository/PriceAlertsRepository.kt"
click node_alertsdb "https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/data/local/PriceAlertsDatabase.kt"
click node_scheduler "https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/alerts/PriceAlertWorker.kt"
click node_worker "https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/alerts/PriceAlertWorker.kt"
click node_notifier "https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/alerts/PriceAlertNotifier.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_user toneBlue
class node_marketui,node_marketvm,node_marketrepo,node_coinlore,node_marketcache,node_detailui,node_detailrepo,node_gecko toneAmber
class node_exchange,node_favoritesui,node_favoritesrepo,node_favoritesdb,node_settingsui,node_currencyrepo,node_themerepo toneMint
class node_alertsui,node_alertsrepo,node_alertsdb,node_scheduler,node_worker,node_notifier toneRose
class node_android toneIndigo
```

## Components

### App and navigation

- [Main activity](https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/MainActivity.kt): `app/src/main/java/com/ngyennhi/cryptotracker/MainActivity.kt`
- [Compose navigation](https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/ui/navigation/CryptoTrackerApp.kt): `app/src/main/java/com/ngyennhi/cryptotracker/ui/navigation/CryptoTrackerApp.kt`

### Market and coin data

- [Market screen](https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/ui/market/MarketScreen.kt): `app/src/main/java/com/ngyennhi/cryptotracker/ui/market/MarketScreen.kt`
- [Market ViewModel](https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/ui/market/MarketViewModel.kt): `app/src/main/java/com/ngyennhi/cryptotracker/ui/market/MarketViewModel.kt`
- [Market repository](https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/data/repository/MarketRepository.kt): `app/src/main/java/com/ngyennhi/cryptotracker/data/repository/MarketRepository.kt`
- [CoinLore API](https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/data/remote/CoinLoreApi.kt): `app/src/main/java/com/ngyennhi/cryptotracker/data/remote/CoinLoreApi.kt`
- [Market cache](https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/data/local/MarketCacheDao.kt): `app/src/main/java/com/ngyennhi/cryptotracker/data/local/MarketCacheDao.kt`
- [Coin detail screen](https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/ui/detail/CoinDetailScreen.kt): `app/src/main/java/com/ngyennhi/cryptotracker/ui/detail/CoinDetailScreen.kt`
- [Detail repository](https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/data/repository/CoinDetailRepository.kt): `app/src/main/java/com/ngyennhi/cryptotracker/data/repository/CoinDetailRepository.kt`
- [CoinGecko API](https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/data/remote/CoinGeckoApi.kt): `app/src/main/java/com/ngyennhi/cryptotracker/data/remote/CoinGeckoApi.kt`

### Preferences and favorites

- [Exchange-rate API](https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/data/remote/ExchangeRateApi.kt): `app/src/main/java/com/ngyennhi/cryptotracker/data/remote/ExchangeRateApi.kt`
- [Favorites screen](https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/ui/favorites/FavoritesScreen.kt): `app/src/main/java/com/ngyennhi/cryptotracker/ui/favorites/FavoritesScreen.kt`
- [Favorites repository](https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/data/repository/FavoritesRepository.kt): `app/src/main/java/com/ngyennhi/cryptotracker/data/repository/FavoritesRepository.kt`
- [Favorites database](https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/data/local/FavoritesDatabase.kt): `app/src/main/java/com/ngyennhi/cryptotracker/data/local/FavoritesDatabase.kt`
- [Settings screen](https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/ui/settings/SettingsScreen.kt): `app/src/main/java/com/ngyennhi/cryptotracker/ui/settings/SettingsScreen.kt`
- [Currency preferences](https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/data/repository/CurrencyPreferencesRepository.kt): `app/src/main/java/com/ngyennhi/cryptotracker/data/repository/CurrencyPreferencesRepository.kt`
- [Theme preferences](https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/data/repository/ThemePreferencesRepository.kt): `app/src/main/java/com/ngyennhi/cryptotracker/data/repository/ThemePreferencesRepository.kt`

### Price alerts

- [Alert controls](https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/ui/detail/CoinDetailScreen.kt): `app/src/main/java/com/ngyennhi/cryptotracker/ui/detail/CoinDetailScreen.kt`
- [Alerts repository](https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/data/repository/PriceAlertsRepository.kt): `app/src/main/java/com/ngyennhi/cryptotracker/data/repository/PriceAlertsRepository.kt`
- [Alerts database](https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/data/local/PriceAlertsDatabase.kt): `app/src/main/java/com/ngyennhi/cryptotracker/data/local/PriceAlertsDatabase.kt`
- [Alert scheduler](https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/alerts/PriceAlertWorker.kt): `app/src/main/java/com/ngyennhi/cryptotracker/alerts/PriceAlertWorker.kt`
- [Alert worker](https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/alerts/PriceAlertWorker.kt): `app/src/main/java/com/ngyennhi/cryptotracker/alerts/PriceAlertWorker.kt`
- [Notification delivery](https://github.com/nhingyen/crypto-tracker/blob/develop/app/src/main/java/com/ngyennhi/cryptotracker/alerts/PriceAlertNotifier.kt): `app/src/main/java/com/ngyennhi/cryptotracker/alerts/PriceAlertNotifier.kt`

### Other components

- **App user**
- **Android notifications**

## Connections

- App user → Main activity: opens app (evidence: `README.md`)
- Main activity → Compose navigation: launches (evidence: `app/src/main/java/com/ngyennhi/cryptotracker/MainActivity.kt`)
- Compose navigation → Market screen: routes to (evidence: `app/src/main/java/com/ngyennhi/cryptotracker/ui/navigation/CryptoTrackerApp.kt`)
- Compose navigation → Coin detail screen: routes to (evidence: `app/src/main/java/com/ngyennhi/cryptotracker/ui/navigation/CryptoTrackerApp.kt`)
- Compose navigation → Favorites screen: routes to (evidence: `app/src/main/java/com/ngyennhi/cryptotracker/ui/navigation/CryptoTrackerApp.kt`)
- Compose navigation → Settings screen: shows (evidence: `app/src/main/java/com/ngyennhi/cryptotracker/ui/navigation/CryptoTrackerApp.kt`)
- Market screen → Market ViewModel: uses state (evidence: `app/src/main/java/com/ngyennhi/cryptotracker/ui/market/MarketScreen.kt`)
- Market ViewModel → Market repository: loads market (evidence: `README.md`)
- Market repository → CoinLore API: fetches data (evidence: `app/src/main/java/com/ngyennhi/cryptotracker/data/repository/MarketRepository.kt`)
- Market repository → Market cache: reads and writes (evidence: `app/src/main/java/com/ngyennhi/cryptotracker/data/repository/MarketRepository.kt`)
- Coin detail screen → Detail repository: loads detail (evidence: `README.md`)
- Detail repository → CoinLore API: fetches detail (evidence: `app/src/main/java/com/ngyennhi/cryptotracker/data/repository/CoinDetailRepository.kt`)
- Detail repository → CoinGecko API: enriches detail (evidence: `app/src/main/java/com/ngyennhi/cryptotracker/data/repository/CoinDetailRepository.kt`)
- Coin detail screen → Alerts repository: edits alerts (evidence: `README.md`)
- Favorites screen → Favorites repository: reads favorites (evidence: `README.md`)
- Favorites repository → Favorites database: persists locally
- Settings screen → Currency preferences: sets currency (evidence: `README.md`)
- Settings screen → Theme preferences: sets theme (evidence: `README.md`)
- Currency preferences → Exchange-rate API: gets conversion rate (evidence: `README.md`)
- Alerts repository → Alerts database: stores alerts (evidence: `app/src/main/java/com/ngyennhi/cryptotracker/data/repository/PriceAlertsRepository.kt`)
- Alerts repository → Alert scheduler: schedules checks (evidence: `app/src/main/java/com/ngyennhi/cryptotracker/data/repository/PriceAlertsRepository.kt`)
- Alert scheduler → Alert worker: enqueues work (evidence: `app/src/main/java/com/ngyennhi/cryptotracker/alerts/PriceAlertWorker.kt`)
- Alert worker → Alerts database: reads and updates (evidence: `app/src/main/java/com/ngyennhi/cryptotracker/alerts/PriceAlertWorker.kt`)
- Alert worker → Detail repository: loads current price (evidence: `app/src/main/java/com/ngyennhi/cryptotracker/alerts/PriceAlertWorker.kt`)
- Alert worker → Notification delivery: posts triggered alert (evidence: `app/src/main/java/com/ngyennhi/cryptotracker/alerts/PriceAlertWorker.kt`)
- Notification delivery → Android notifications: posts notification (evidence: `README.md`)
