How mihaicristiancondrea/app-toolkit-for-android works
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: DataStoreShellPreferencesRepository.kt Shell preferences · ShellHost.kt Shell host · DefaultUsageAndDiagnosticsRepository.kt Diagnostics settings · AppOpenAdController.kt Ads integration
Components 25
Host entry
- Toolkit assembly
library/apptoolkit/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/di/modules/AppToolkitModules.kt - Toolkit graph
library/apptoolkit/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/app/main/ui/navigation/ToolkitGraph.kt
Navigation shell
- Shell host
library/shell/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/shell/ShellHost.kt - Navigation core
library/navigation/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/navigation - Shell chrome
library/shell/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/shell/chrome/ShellChromeController.kt - Shell preferences
library/shell/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/shell/data/repositories/DataStoreShellPreferencesRepository.kt - Shell settings store
Toolkit features
- Permission usage
library/apptoolkit/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/app/privacy/ui/PermissionUsageActivity.kt - Issue reporter
library/feature/issuereporter/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/feature/issuereporter/ui/utils/IssueReporterShakeManager.kt - Seasonal themes
library/feature/theme/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/feature/theme/ui/features/seasonal/SeasonalThemeManager.kt - Diagnostics settings
library/feature/diagnostics/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/feature/diagnostics/data/repositories/DefaultUsageAndDiagnosticsRepository.kt
Shared foundations
- Common services
library/core/common/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/core/common/coroutines/dispatchers/DispatcherProvider.kt - Storage errors
library/core/common/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/core/common/data/exceptions/StorageException.kt - Preferences data
library/core/datastore/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/core/datastore/data/local/CommonDataStore.kt - Design system
library/core/designsystem/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/core/designsystem
Optional integrations
- Ads integration
library/integration/ads/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/integration/ads/ui/utils/AppOpenAdController.kt - Billing integration
library/integration/billing/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/integration/billing/data/repositories/DefaultBillingRepository.kt - Consent integration
library/integration/consent/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/integration/consent/data/repositories/DefaultConsentRepository.kt - Firebase notifications
library/integration/firebase/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/integration/firebase/data/notifications/FirebaseNotificationsService.kt - In-app review
library/integration/review/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/integration/review/data/repositories/DefaultReviewRepository.kt - In-app updates
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 21
- Android host app → Toolkit assembly: assembles
README.md - Android host app → Toolkit graph: registers pages
README.md - Toolkit graph → Shell host: hosts graph
README.md - Toolkit assembly → Permission usage: exports modules
README.md - Shell host → Navigation core: hosts navigation
README.md - Shell host → Shell chrome: controls chrome
README.md - Shell host → Shell preferences: reads settings
- Shell preferences → Shell settings store: reads and writes
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
library/feature/diagnostics/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/feature/diagnostics/data/repositories/DefaultUsageAndDiagnosticsRepository.kt - Diagnostics settings → Storage errors: maps failures
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
library/shell/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/shell/data/repositories/DataStoreShellPreferencesRepository.kt - Shell preferences → Navigation core: uses layout options
library/shell/src/main/kotlin/com/mihaicristiancondrea/android/libs/apptoolkit/shell/data/repositories/DataStoreShellPreferencesRepository.kt - Ads integration → Common services: uses dispatchers
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
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