How nhingyen/crypto-tracker works
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: CryptoTrackerApp.kt Compose navigation · PriceAlertWorker.kt Alert worker · CoinDetailRepository.kt Detail repository · MarketRepository.kt Market repository
Components 25
App and navigation
- Main activity
app/src/main/java/com/ngyennhi/cryptotracker/MainActivity.kt - Compose navigation
app/src/main/java/com/ngyennhi/cryptotracker/ui/navigation/CryptoTrackerApp.kt
Market and coin data
- Market screen
app/src/main/java/com/ngyennhi/cryptotracker/ui/market/MarketScreen.kt - Market ViewModel
app/src/main/java/com/ngyennhi/cryptotracker/ui/market/MarketViewModel.kt - Market repository
app/src/main/java/com/ngyennhi/cryptotracker/data/repository/MarketRepository.kt - CoinLore API
app/src/main/java/com/ngyennhi/cryptotracker/data/remote/CoinLoreApi.kt - Market cache
app/src/main/java/com/ngyennhi/cryptotracker/data/local/MarketCacheDao.kt - Coin detail screen
app/src/main/java/com/ngyennhi/cryptotracker/ui/detail/CoinDetailScreen.kt - Detail repository
app/src/main/java/com/ngyennhi/cryptotracker/data/repository/CoinDetailRepository.kt - CoinGecko API
app/src/main/java/com/ngyennhi/cryptotracker/data/remote/CoinGeckoApi.kt
Preferences and favorites
- Exchange-rate API
app/src/main/java/com/ngyennhi/cryptotracker/data/remote/ExchangeRateApi.kt - Favorites screen
app/src/main/java/com/ngyennhi/cryptotracker/ui/favorites/FavoritesScreen.kt - Favorites repository
app/src/main/java/com/ngyennhi/cryptotracker/data/repository/FavoritesRepository.kt - Favorites database
app/src/main/java/com/ngyennhi/cryptotracker/data/local/FavoritesDatabase.kt - Settings screen
app/src/main/java/com/ngyennhi/cryptotracker/ui/settings/SettingsScreen.kt - Currency preferences
app/src/main/java/com/ngyennhi/cryptotracker/data/repository/CurrencyPreferencesRepository.kt - Theme preferences
app/src/main/java/com/ngyennhi/cryptotracker/data/repository/ThemePreferencesRepository.kt
Price alerts
- Alert controls
app/src/main/java/com/ngyennhi/cryptotracker/ui/detail/CoinDetailScreen.kt - Alerts repository
app/src/main/java/com/ngyennhi/cryptotracker/data/repository/PriceAlertsRepository.kt - Alerts database
app/src/main/java/com/ngyennhi/cryptotracker/data/local/PriceAlertsDatabase.kt - Alert scheduler
app/src/main/java/com/ngyennhi/cryptotracker/alerts/PriceAlertWorker.kt - Alert worker
app/src/main/java/com/ngyennhi/cryptotracker/alerts/PriceAlertWorker.kt - Notification delivery
app/src/main/java/com/ngyennhi/cryptotracker/alerts/PriceAlertNotifier.kt
Other components
- App user
- Android notifications
Connections 26
- App user → Main activity: opens app
README.md - Main activity → Compose navigation: launches
app/src/main/java/com/ngyennhi/cryptotracker/MainActivity.kt - Compose navigation → Market screen: routes to
app/src/main/java/com/ngyennhi/cryptotracker/ui/navigation/CryptoTrackerApp.kt - Compose navigation → Coin detail screen: routes to
app/src/main/java/com/ngyennhi/cryptotracker/ui/navigation/CryptoTrackerApp.kt - Compose navigation → Favorites screen: routes to
app/src/main/java/com/ngyennhi/cryptotracker/ui/navigation/CryptoTrackerApp.kt - Compose navigation → Settings screen: shows
app/src/main/java/com/ngyennhi/cryptotracker/ui/navigation/CryptoTrackerApp.kt - Market screen → Market ViewModel: uses state
app/src/main/java/com/ngyennhi/cryptotracker/ui/market/MarketScreen.kt - Market ViewModel → Market repository: loads market
README.md - Market repository → CoinLore API: fetches data
app/src/main/java/com/ngyennhi/cryptotracker/data/repository/MarketRepository.kt - Market repository → Market cache: reads and writes
app/src/main/java/com/ngyennhi/cryptotracker/data/repository/MarketRepository.kt - Coin detail screen → Detail repository: loads detail
README.md - Detail repository → CoinLore API: fetches detail
app/src/main/java/com/ngyennhi/cryptotracker/data/repository/CoinDetailRepository.kt - Detail repository → CoinGecko API: enriches detail
app/src/main/java/com/ngyennhi/cryptotracker/data/repository/CoinDetailRepository.kt - Coin detail screen → Alerts repository: edits alerts
README.md - Favorites screen → Favorites repository: reads favorites
README.md - Favorites repository → Favorites database: persists locally
- Settings screen → Currency preferences: sets currency
README.md - Settings screen → Theme preferences: sets theme
README.md - Currency preferences → Exchange-rate API: gets conversion rate
README.md - Alerts repository → Alerts database: stores alerts
app/src/main/java/com/ngyennhi/cryptotracker/data/repository/PriceAlertsRepository.kt - Alerts repository → Alert scheduler: schedules checks
app/src/main/java/com/ngyennhi/cryptotracker/data/repository/PriceAlertsRepository.kt - Alert scheduler → Alert worker: enqueues work
app/src/main/java/com/ngyennhi/cryptotracker/alerts/PriceAlertWorker.kt - Alert worker → Alerts database: reads and updates
app/src/main/java/com/ngyennhi/cryptotracker/alerts/PriceAlertWorker.kt - Alert worker → Detail repository: loads current price
app/src/main/java/com/ngyennhi/cryptotracker/alerts/PriceAlertWorker.kt - Alert worker → Notification delivery: posts triggered alert
app/src/main/java/com/ngyennhi/cryptotracker/alerts/PriceAlertWorker.kt - Notification delivery → Android notifications: posts notification
README.md