# mihaicristiancondrea/app-toolkit-for-android architecture

> Architecture diagram of the GitHub repository mihaicristiancondrea/app-toolkit-for-android, 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/mihaicristiancondrea/app-toolkit-for-android
- Repository: https://github.com/mihaicristiancondrea/app-toolkit-for-android

## Overview

App Toolkit is a modular Android library for reusable foundations, feature screens, optional SDK integrations, and a one-activity navigation shell. A host app uses the toolkit entry point to assemble modules and register pages; people then navigate the shell and use toolkit features. The README also identifies ads, billing, consent, Firebase, review, and update integrations as optional capabilities. Sampled source confirms selected shell persistence, diagnostics consent, shake reporting, ads, and review behavior; unsampled feature relationships are shown only where documented.

Main entry points: [`library/shell/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/shell/data/repositories/DataStoreShellPreferencesRepository.kt`](https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/shell/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/shell/data/repositories/DataStoreShellPreferencesRepository.kt) (Shell preferences), [`library/shell/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/shell/ShellHost.kt`](https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/shell/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/shell/ShellHost.kt) (Shell host), [`library/feature/diagnostics/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/feature/diagnostics/data/repositories/DefaultUsageAndDiagnosticsRepository.kt`](https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/feature/diagnostics/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/feature/diagnostics/data/repositories/DefaultUsageAndDiagnosticsRepository.kt) (Diagnostics settings), [`library/integration/ads/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/integration/ads/ui/utils/AppOpenAdController.kt`](https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/integration/ads/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/integration/ads/ui/utils/AppOpenAdController.kt) (Ads integration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Host entry"]
  node_toolkit["Toolkit assembly"]
  node_toolkitgraph["Toolkit graph<br/>[ToolkitGraph.kt]"]
end

subgraph group_shell["Navigation shell"]
  node_shellhost["Shell host<br/>[ShellHost.kt]"]
  node_navigation["Navigation core"]
  node_chrome["Shell chrome"]
  node_shellprefs["Shell preferences"]
  node_shellstore[("Shell settings store")]
end

subgraph group_features["Toolkit features"]
  node_permissions["Permission usage"]
  node_issue["Issue reporter"]
  node_theme["Seasonal themes"]
  node_diagnostics["Diagnostics settings"]
end

subgraph group_foundation["Shared foundations"]
  node_common["Common services"]
  node_storageerrors["Storage errors"]
  node_datastore[("Preferences data<br/>[CommonDataStore.kt]")]
  node_designsystem["Design system"]
end

subgraph group_integrations["Optional integrations"]
  node_ads["Ads integration"]
  node_billing["Billing integration"]
  node_consent["Consent integration"]
  node_firebase["Firebase notifications"]
  node_review["In-app review"]
  node_updates["In-app updates"]
end

node_host(("Android host app"))
node_play(("Google Play services"))
node_adplatform(("Ad platform"))
node_firebaseplatform(("Firebase"))

node_host -->|"assembles"| node_toolkit
node_host -->|"registers pages"| node_toolkitgraph
node_toolkitgraph -->|"hosts graph"| node_shellhost
node_toolkit -->|"exports modules"| node_permissions
node_shellhost -->|"hosts navigation"| node_navigation
node_shellhost -->|"controls chrome"| node_chrome
node_shellhost -->|"reads settings"| node_shellprefs
node_shellprefs -->|"reads and writes"| node_shellstore
node_issue -.->|"uses dispatchers"| node_common
node_diagnostics -->|"applies consent"| node_consent
node_diagnostics -->|"maps failures"| node_storageerrors
node_shellprefs -.->|"reports failures"| node_storageerrors
node_shellprefs -->|"uses motion settings"| node_designsystem
node_shellprefs -->|"uses layout options"| node_navigation
node_ads -->|"uses dispatchers"| node_common
node_ads -.->|"initializes and shows"| node_adplatform
node_review -->|"requests review flow"| node_play
node_billing -.->|"uses billing services"| node_play
node_updates -.->|"checks for updates"| node_play
node_firebase -.->|"receives notifications"| node_firebaseplatform
node_theme -.->|"applies theme effects"| node_designsystem

click node_toolkit "https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/apptoolkit/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/di/modules/AppToolkitModules.kt"
click node_toolkitgraph "https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/apptoolkit/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/app/main/ui/navigation/ToolkitGraph.kt"
click node_shellhost "https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/shell/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/shell/ShellHost.kt"
click node_navigation "https://github.com/mihaicristiancondrea/app-toolkit-for-android/tree/master/library/navigation/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/navigation"
click node_chrome "https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/shell/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/shell/chrome/ShellChromeController.kt"
click node_shellprefs "https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/shell/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/shell/data/repositories/DataStoreShellPreferencesRepository.kt"
click node_permissions "https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/apptoolkit/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/app/privacy/ui/PermissionUsageActivity.kt"
click node_issue "https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/feature/issuereporter/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/feature/issuereporter/ui/utils/IssueReporterShakeManager.kt"
click node_theme "https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/feature/theme/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/feature/theme/ui/features/seasonal/SeasonalThemeManager.kt"
click node_diagnostics "https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/feature/diagnostics/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/feature/diagnostics/data/repositories/DefaultUsageAndDiagnosticsRepository.kt"
click node_common "https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/core/common/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/core/common/coroutines/dispatchers/DispatcherProvider.kt"
click node_storageerrors "https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/core/common/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/core/common/data/exceptions/StorageException.kt"
click node_datastore "https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/core/datastore/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/core/datastore/data/local/CommonDataStore.kt"
click node_designsystem "https://github.com/mihaicristiancondrea/app-toolkit-for-android/tree/master/library/core/designsystem/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/core/designsystem"
click node_ads "https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/integration/ads/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/integration/ads/ui/utils/AppOpenAdController.kt"
click node_billing "https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/integration/billing/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/integration/billing/data/repositories/DefaultBillingRepository.kt"
click node_consent "https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/integration/consent/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/integration/consent/data/repositories/DefaultConsentRepository.kt"
click node_firebase "https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/integration/firebase/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/integration/firebase/data/notifications/FirebaseNotificationsService.kt"
click node_review "https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/integration/review/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/integration/review/data/repositories/DefaultReviewRepository.kt"
click node_updates "https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/integration/update/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/integration/update/data/repositories/DefaultInAppUpdateRepository.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_toolkit,node_toolkitgraph toneBlue
class node_shellhost,node_navigation,node_chrome,node_shellprefs,node_shellstore toneAmber
class node_permissions,node_issue,node_theme,node_diagnostics toneMint
class node_common,node_storageerrors,node_datastore,node_designsystem toneRose
class node_ads,node_billing,node_consent,node_firebase,node_review,node_updates,node_host,node_play,node_adplatform,node_firebaseplatform toneIndigo
```

## Components

### Host entry

- [Toolkit assembly](https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/apptoolkit/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/di/modules/AppToolkitModules.kt): `library/apptoolkit/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/di/modules/AppToolkitModules.kt`
- [Toolkit graph](https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/apptoolkit/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/app/main/ui/navigation/ToolkitGraph.kt): `library/apptoolkit/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/app/main/ui/navigation/ToolkitGraph.kt`

### Navigation shell

- [Shell host](https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/shell/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/shell/ShellHost.kt): `library/shell/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/shell/ShellHost.kt`
- [Navigation core](https://github.com/mihaicristiancondrea/app-toolkit-for-android/tree/master/library/navigation/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/navigation): `library/navigation/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/navigation`
- [Shell chrome](https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/shell/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/shell/chrome/ShellChromeController.kt): `library/shell/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/shell/chrome/ShellChromeController.kt`
- [Shell preferences](https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/shell/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/shell/data/repositories/DataStoreShellPreferencesRepository.kt): `library/shell/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/shell/data/repositories/DataStoreShellPreferencesRepository.kt`
- **Shell settings store**

### Toolkit features

- [Permission usage](https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/apptoolkit/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/app/privacy/ui/PermissionUsageActivity.kt): `library/apptoolkit/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/app/privacy/ui/PermissionUsageActivity.kt`
- [Issue reporter](https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/feature/issuereporter/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/feature/issuereporter/ui/utils/IssueReporterShakeManager.kt): `library/feature/issuereporter/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/feature/issuereporter/ui/utils/IssueReporterShakeManager.kt`
- [Seasonal themes](https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/feature/theme/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/feature/theme/ui/features/seasonal/SeasonalThemeManager.kt): `library/feature/theme/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/feature/theme/ui/features/seasonal/SeasonalThemeManager.kt`
- [Diagnostics settings](https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/feature/diagnostics/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/feature/diagnostics/data/repositories/DefaultUsageAndDiagnosticsRepository.kt): `library/feature/diagnostics/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/feature/diagnostics/data/repositories/DefaultUsageAndDiagnosticsRepository.kt`

### Shared foundations

- [Common services](https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/core/common/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/core/common/coroutines/dispatchers/DispatcherProvider.kt): `library/core/common/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/core/common/coroutines/dispatchers/DispatcherProvider.kt`
- [Storage errors](https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/core/common/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/core/common/data/exceptions/StorageException.kt): `library/core/common/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/core/common/data/exceptions/StorageException.kt`
- [Preferences data](https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/core/datastore/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/core/datastore/data/local/CommonDataStore.kt): `library/core/datastore/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/core/datastore/data/local/CommonDataStore.kt`
- [Design system](https://github.com/mihaicristiancondrea/app-toolkit-for-android/tree/master/library/core/designsystem/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/core/designsystem): `library/core/designsystem/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/core/designsystem`

### Optional integrations

- [Ads integration](https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/integration/ads/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/integration/ads/ui/utils/AppOpenAdController.kt): `library/integration/ads/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/integration/ads/ui/utils/AppOpenAdController.kt`
- [Billing integration](https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/integration/billing/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/integration/billing/data/repositories/DefaultBillingRepository.kt): `library/integration/billing/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/integration/billing/data/repositories/DefaultBillingRepository.kt`
- [Consent integration](https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/integration/consent/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/integration/consent/data/repositories/DefaultConsentRepository.kt): `library/integration/consent/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/integration/consent/data/repositories/DefaultConsentRepository.kt`
- [Firebase notifications](https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/integration/firebase/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/integration/firebase/data/notifications/FirebaseNotificationsService.kt): `library/integration/firebase/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/integration/firebase/data/notifications/FirebaseNotificationsService.kt`
- [In-app review](https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/integration/review/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/integration/review/data/repositories/DefaultReviewRepository.kt): `library/integration/review/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/integration/review/data/repositories/DefaultReviewRepository.kt`
- [In-app updates](https://github.com/mihaicristiancondrea/app-toolkit-for-android/blob/master/library/integration/update/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/integration/update/data/repositories/DefaultInAppUpdateRepository.kt): `library/integration/update/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/integration/update/data/repositories/DefaultInAppUpdateRepository.kt`

### Other components

- **Android host app**
- **Google Play services**
- **Ad platform**
- **Firebase**

## Connections

- Android host app → Toolkit assembly: assembles (evidence: `README.md`)
- Android host app → Toolkit graph: registers pages (evidence: `README.md`)
- Toolkit graph → Shell host: hosts graph (evidence: `README.md`)
- Toolkit assembly → Permission usage: exports modules (evidence: `README.md`)
- Shell host → Navigation core: hosts navigation (evidence: `README.md`)
- Shell host → Shell chrome: controls chrome (evidence: `README.md`)
- Shell host → Shell preferences: reads settings
- Shell preferences → Shell settings store: reads and writes (evidence: `library/shell/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/shell/data/repositories/DataStoreShellPreferencesRepository.kt`)
- Issue reporter → Common services: uses dispatchers
- Diagnostics settings → Consent integration: applies consent (evidence: `library/feature/diagnostics/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/feature/diagnostics/data/repositories/DefaultUsageAndDiagnosticsRepository.kt`)
- Diagnostics settings → Storage errors: maps failures (evidence: `library/feature/diagnostics/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/feature/diagnostics/data/repositories/DefaultUsageAndDiagnosticsRepository.kt`)
- Shell preferences → Storage errors: reports failures
- Shell preferences → Design system: uses motion settings (evidence: `library/shell/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/shell/data/repositories/DataStoreShellPreferencesRepository.kt`)
- Shell preferences → Navigation core: uses layout options (evidence: `library/shell/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/shell/data/repositories/DataStoreShellPreferencesRepository.kt`)
- Ads integration → Common services: uses dispatchers (evidence: `library/integration/ads/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/integration/ads/ui/utils/AppOpenAdController.kt`)
- Ads integration → Ad platform: initializes and shows
- In-app review → Google Play services: requests review flow (evidence: `library/integration/review/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/integration/review/data/repositories/DefaultReviewRepository.kt`)
- Billing integration → Google Play services: uses billing services
- In-app updates → Google Play services: checks for updates
- Firebase notifications → Firebase: receives notifications
- Seasonal themes → Design system: applies theme effects
