# jlpa-lab/trackerapp architecture

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

- Interactive diagram: https://gitdiagram.com/jlpa-lab/trackerapp
- Repository: https://github.com/jlpa-lab/trackerapp

## Overview

Lumora is an Android app whose visible runtime centers on app startup and navigation, language selection/onboarding, advertising, and notification delivery. The sampled tree exposes no generation or other content-creation workflow, so the graph does not infer one. AdsManager coordinates ad eligibility and format managers; notifications are dispatched through a service to handlers and OneSignal. Several connections come from the source index or documented structure rather than complete excerpts, so uncertain links are omitted.

Main entry points: [`app/src/main/java/com/mobile/trackerapp/ads/AdsManager.kt`](https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/ads/AdsManager.kt) (Ads manager), [`app/src/main/java/com/mobile/trackerapp/MainActivity.kt`](https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/MainActivity.kt) (Main activity), [`app/src/main/java/com/mobile/trackerapp/navigation/NavGraph.kt`](https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/navigation/NavGraph.kt) (Navigation graph), [`app/src/main/java/com/mobile/trackerapp/language/LanguageRoute.kt`](https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/language/LanguageRoute.kt) (Language route)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and navigation"]
  node_activity["Main activity<br/>[MainActivity.kt]"]
  node_nav["Navigation graph<br/>[NavGraph.kt]"]
  node_preferences[("Onboarding preferences")]
end

subgraph group_language["Language onboarding"]
  node_language_route["Language route<br/>[LanguageRoute.kt]"]
  node_language_screen["Language screen<br/>[LanguageScreen.kt]"]
  node_language_vm["Language view model"]
  node_locale["Locale manager<br/>[LocaleManager.kt]"]
end

subgraph group_ads["Advertising"]
  node_ads_manager["Ads manager<br/>[AdsManager.kt]"]
  node_ads_config["Ads configuration<br/>[AdsConfigStore.kt]"]
  node_frequency["Frequency policy"]
  node_interstitial["Interstitial ads"]
  node_rewarded["Rewarded ads"]
  node_appopen["App-open ads"]
  node_banner["Persistent banner"]
  node_native["Native ads<br/>[NativeAdManager.kt]"]
  node_ad_placement["Ad placements<br/>[AdPlacement.kt]"]
  node_ad_revenue["Revenue tracking"]
end

subgraph group_notifications["Notifications"]
  node_notification_service["Notification service"]
  node_notification_handler["Notification handlers"]
  node_notification_repo[("Notification repository")]
  node_notification_model["Notification model<br/>[Notification.kt]"]
  node_onesignal["OneSignal integration"]
end

node_user(("App user"))
node_remote_config["Firebase Remote Config"]
node_admob["Google Mobile Ads"]

node_user -->|"opens"| node_activity
node_activity -->|"renders"| node_nav
node_activity -->|"initializes"| node_ads_manager
node_activity -->|"loads"| node_ads_config
node_activity -->|"applies locale"| node_locale
node_activity -->|"renders"| node_banner
node_nav -->|"routes to"| node_language_route
node_nav -->|"reads"| node_preferences
node_nav -->|"places"| node_banner
node_language_route -->|"renders"| node_language_screen
node_language_route -->|"observes"| node_language_vm
node_language_route -->|"sets locale"| node_locale
node_ads_manager -->|"reads"| node_ads_config
node_ads_manager -->|"checks"| node_frequency
node_ads_manager -->|"delegates"| node_interstitial
node_ads_manager -->|"delegates"| node_rewarded
node_ads_manager -->|"delegates"| node_appopen
node_ads_manager -->|"delegates"| node_native
node_ads_config -->|"fetches settings"| node_remote_config
node_interstitial -->|"loads and shows"| node_admob
node_rewarded -->|"loads and shows"| node_admob
node_appopen -->|"loads and shows"| node_admob
node_ad_placement -->|"keys settings"| node_ads_config
node_notification_service -->|"dispatches"| node_notification_handler
node_notification_service -->|"manages subscription"| node_onesignal
node_notification_handler -->|"uses"| node_notification_repo
node_notification_service -->|"uses"| node_notification_model
node_notification_repo -->|"stores"| node_notification_model

click node_activity "https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/MainActivity.kt"
click node_nav "https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/navigation/NavGraph.kt"
click node_preferences "https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/utils/OnboardingPreferences.kt"
click node_language_route "https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/language/LanguageRoute.kt"
click node_language_screen "https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/language/LanguageScreen.kt"
click node_language_vm "https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/language/LanguageViewModel.kt"
click node_locale "https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/core/localization/LocaleManager.kt"
click node_ads_manager "https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/ads/AdsManager.kt"
click node_ads_config "https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/ads/AdsConfigStore.kt"
click node_frequency "https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/ads/AdsFrequencyManager.kt"
click node_interstitial "https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/ads/interstitial/InterstitialAdManager.kt"
click node_rewarded "https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/ads/rewarded/RewardedAdManager.kt"
click node_appopen "https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/ads/appopen/AppOpenAdManager.kt"
click node_banner "https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/ads/banner/PersistentBannerAd.kt"
click node_native "https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/ads/nativead/NativeAdManager.kt"
click node_ad_placement "https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/ads/AdPlacement.kt"
click node_ad_revenue "https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/ads/AdRevenueTracker.kt"
click node_notification_service "https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/notification/NotificationService.kt"
click node_notification_handler "https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/notification/NotificationHandler.kt"
click node_notification_repo "https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/data/repository/NotificationRepository.kt"
click node_notification_model "https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/domain/model/Notification.kt"
click node_onesignal "https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/notification/OneSignalManager.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_nav,node_preferences,node_user toneBlue
class node_language_route,node_language_screen,node_language_vm,node_locale toneAmber
class node_ads_manager,node_ads_config,node_frequency,node_interstitial,node_rewarded,node_appopen,node_banner,node_native,node_ad_placement,node_ad_revenue toneMint
class node_notification_service,node_notification_handler,node_notification_repo,node_notification_model,node_onesignal toneRose
class node_remote_config,node_admob toneIndigo
```

## Components

### App and navigation

- [Main activity](https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/MainActivity.kt): `app/src/main/java/com/mobile/trackerapp/MainActivity.kt`
- [Navigation graph](https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/navigation/NavGraph.kt): `app/src/main/java/com/mobile/trackerapp/navigation/NavGraph.kt`
- [Onboarding preferences](https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/utils/OnboardingPreferences.kt): `app/src/main/java/com/mobile/trackerapp/utils/OnboardingPreferences.kt`

### Language onboarding

- [Language route](https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/language/LanguageRoute.kt): `app/src/main/java/com/mobile/trackerapp/language/LanguageRoute.kt`
- [Language screen](https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/language/LanguageScreen.kt): `app/src/main/java/com/mobile/trackerapp/language/LanguageScreen.kt`
- [Language view model](https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/language/LanguageViewModel.kt): `app/src/main/java/com/mobile/trackerapp/language/LanguageViewModel.kt`
- [Locale manager](https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/core/localization/LocaleManager.kt): `app/src/main/java/com/mobile/trackerapp/core/localization/LocaleManager.kt`

### Advertising

- [Ads manager](https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/ads/AdsManager.kt): `app/src/main/java/com/mobile/trackerapp/ads/AdsManager.kt`
- [Ads configuration](https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/ads/AdsConfigStore.kt): `app/src/main/java/com/mobile/trackerapp/ads/AdsConfigStore.kt`
- [Frequency policy](https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/ads/AdsFrequencyManager.kt): `app/src/main/java/com/mobile/trackerapp/ads/AdsFrequencyManager.kt`
- [Interstitial ads](https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/ads/interstitial/InterstitialAdManager.kt): `app/src/main/java/com/mobile/trackerapp/ads/interstitial/InterstitialAdManager.kt`
- [Rewarded ads](https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/ads/rewarded/RewardedAdManager.kt): `app/src/main/java/com/mobile/trackerapp/ads/rewarded/RewardedAdManager.kt`
- [App-open ads](https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/ads/appopen/AppOpenAdManager.kt): `app/src/main/java/com/mobile/trackerapp/ads/appopen/AppOpenAdManager.kt`
- [Persistent banner](https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/ads/banner/PersistentBannerAd.kt): `app/src/main/java/com/mobile/trackerapp/ads/banner/PersistentBannerAd.kt`
- [Native ads](https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/ads/nativead/NativeAdManager.kt): `app/src/main/java/com/mobile/trackerapp/ads/nativead/NativeAdManager.kt`
- [Ad placements](https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/ads/AdPlacement.kt): `app/src/main/java/com/mobile/trackerapp/ads/AdPlacement.kt`
- [Revenue tracking](https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/ads/AdRevenueTracker.kt): `app/src/main/java/com/mobile/trackerapp/ads/AdRevenueTracker.kt`

### Notifications

- [Notification service](https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/notification/NotificationService.kt): `app/src/main/java/com/mobile/trackerapp/notification/NotificationService.kt`
- [Notification handlers](https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/notification/NotificationHandler.kt): `app/src/main/java/com/mobile/trackerapp/notification/NotificationHandler.kt`
- [Notification repository](https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/data/repository/NotificationRepository.kt): `app/src/main/java/com/mobile/trackerapp/data/repository/NotificationRepository.kt`
- [Notification model](https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/domain/model/Notification.kt): `app/src/main/java/com/mobile/trackerapp/domain/model/Notification.kt`
- [OneSignal integration](https://github.com/jlpa-lab/trackerapp/blob/main/app/src/main/java/com/mobile/trackerapp/notification/OneSignalManager.kt): `app/src/main/java/com/mobile/trackerapp/notification/OneSignalManager.kt`

### Other components

- **App user**
- **Firebase Remote Config**
- **Google Mobile Ads**

## Connections

- App user → Main activity: opens
- Main activity → Navigation graph: renders (evidence: `app/src/main/java/com/mobile/trackerapp/MainActivity.kt`)
- Main activity → Ads manager: initializes (evidence: `app/src/main/java/com/mobile/trackerapp/MainActivity.kt`)
- Main activity → Ads configuration: loads (evidence: `app/src/main/java/com/mobile/trackerapp/MainActivity.kt`)
- Main activity → Locale manager: applies locale (evidence: `app/src/main/java/com/mobile/trackerapp/MainActivity.kt`)
- Main activity → Persistent banner: renders (evidence: `app/src/main/java/com/mobile/trackerapp/MainActivity.kt`)
- Navigation graph → Language route: routes to (evidence: `app/src/main/java/com/mobile/trackerapp/navigation/NavGraph.kt`)
- Navigation graph → Onboarding preferences: reads (evidence: `app/src/main/java/com/mobile/trackerapp/navigation/NavGraph.kt`)
- Navigation graph → Persistent banner: places (evidence: `app/src/main/java/com/mobile/trackerapp/navigation/NavGraph.kt`)
- Language route → Language screen: renders (evidence: `app/src/main/java/com/mobile/trackerapp/language/LanguageRoute.kt`)
- Language route → Language view model: observes (evidence: `app/src/main/java/com/mobile/trackerapp/language/LanguageRoute.kt`)
- Language route → Locale manager: sets locale (evidence: `app/src/main/java/com/mobile/trackerapp/language/LanguageRoute.kt`)
- Ads manager → Ads configuration: reads (evidence: `app/src/main/java/com/mobile/trackerapp/ads/AdsManager.kt`)
- Ads manager → Frequency policy: checks (evidence: `app/src/main/java/com/mobile/trackerapp/ads/AdsManager.kt`)
- Ads manager → Interstitial ads: delegates (evidence: `app/src/main/java/com/mobile/trackerapp/ads/AdsManager.kt`)
- Ads manager → Rewarded ads: delegates (evidence: `app/src/main/java/com/mobile/trackerapp/ads/AdsManager.kt`)
- Ads manager → App-open ads: delegates (evidence: `app/src/main/java/com/mobile/trackerapp/ads/AdsManager.kt`)
- Ads manager → Native ads: delegates (evidence: `app/src/main/java/com/mobile/trackerapp/ads/AdsManager.kt`)
- Ads configuration → Firebase Remote Config: fetches settings (evidence: `app/src/main/java/com/mobile/trackerapp/ads/AdsConfigStore.kt`)
- Interstitial ads → Google Mobile Ads: loads and shows (evidence: `app/src/main/java/com/mobile/trackerapp/ads/interstitial/InterstitialAdManager.kt`)
- Rewarded ads → Google Mobile Ads: loads and shows (evidence: `app/src/main/java/com/mobile/trackerapp/ads/rewarded/RewardedAdManager.kt`)
- App-open ads → Google Mobile Ads: loads and shows (evidence: `app/src/main/java/com/mobile/trackerapp/ads/appopen/AppOpenAdManager.kt`)
- Ad placements → Ads configuration: keys settings (evidence: `app/src/main/java/com/mobile/trackerapp/ads/AdsConfigStore.kt`)
- Notification service → Notification handlers: dispatches (evidence: `app/src/main/java/com/mobile/trackerapp/notification/NotificationService.kt`)
- Notification service → OneSignal integration: manages subscription (evidence: `app/src/main/java/com/mobile/trackerapp/notification/NotificationService.kt`)
- Notification handlers → Notification repository: uses (evidence: `app/src/main/java/com/mobile/trackerapp/notification/NotificationHandler.kt`)
- Notification service → Notification model: uses (evidence: `app/src/main/java/com/mobile/trackerapp/notification/NotificationService.kt`)
- Notification repository → Notification model: stores (evidence: `app/src/main/java/com/mobile/trackerapp/data/repository/NotificationRepository.kt`)
