// Android platform/helper layer guide for AniTrend. Use when working in `:android:*` modules or deciding whether to reuse or extend existing Android-side helpers for configuration/theme, context or fragment utilities, notification permission flows, deep links, drawer/app-shell behavior, or other platform APIs.
Use ADB to connect devices, install Android debug builds, and troubleshoot deployment failures. Use for device detection errors, install failures, launch failures, package selection across flavors, and first-pass process checks. For deeper runtime investigation, prefer the Argent workflow.
Investigate Android runtime bugs with evidence-first Argent workflows. Use for emulator targeting, runtime console/network inspection, UI hierarchy capture, optional native traffic inspection, and root-cause analysis before changing code.
Capture quick Android UI evidence with explicit launches, UIAutomator dumps, and adb screenshots for fast visual debugging and reproducible repro notes.
Instruction-to-skill navigation map. Use when routing tasks to the right instruction and skill files or migrating legacy guidance to the split-doc model.
Step-by-step module creation checklist. Use when adding a new Gradle module and wiring build, DI, and architecture integration correctly.
Diagnose and fix silent empty-UI bugs caused by CacheRequest enum collisions in AniTrend. Use when a new offline-first source variant produces blank UI with no crash, no exception, and the Room tables have zero rows. Covers: cache_log collision diagnosis, ADB Room database forensics, WAL checkpoint, Chucker traffic check, CacheRequest isolation fix, and Koin factory update pattern.
| name | android-platform-patterns |
| description | Android platform/helper layer guide for AniTrend. Use when working in `:android:*` modules or deciding whether to reuse or extend existing Android-side helpers for configuration/theme, context or fragment utilities, notification permission flows, deep links, drawer/app-shell behavior, or other platform APIs. |
:android:* is AniTrend's platform/helper layer. It owns reusable Android-side APIs that should
be shared across the app shell, feature modules, common presenters, and task modules instead of
being recreated inside those entry layers.
Before adding a new helper, wrapper, extension, or provider, inspect the existing platform surfaces first:
:android:core for settings, configuration, theme, Compose primitives, controllers, helpers,
and context/fragment utilities:android:navigation for drawer and app-shell navigation content:android:deeplink for URI entry, parser registration, and external-intent routing:app:core for app-shell integration points that already consume those Android helpersUse the concrete anchors in the layer example matrix when you need a real code path to copy.
:android:core centralizes reusable Android-facing APIs such as Settings,
ConfigurationHelper, AniTrendTheme3, notification helpers, storage/power/shortcut
controllers, and fragment/context utilities.:android:navigation owns the navigation drawer shell: fragment content, drawer presenter,
viewmodels, adapters, and router provider wiring.:android:deeplink owns external URI intake: DeepLinkScreen, parser assembly, route
registration, and the provider that turns a URI into a routed intent.android/core, android/navigation, android/deeplink, and app/core before
creating anything new.feature, common, or task.android/navigation/src/main/kotlin/co/anitrend/android/navigation/ and
app/src/main/kotlin/co/anitrend/component/screen/MainScreen.kt.android/deeplink before touching a
feature module.android/core/src/main/kotlin/co/anitrend/android/core/extensions/ContextExtensions.kt or
app/core/src/main/kotlin/co/anitrend/core/ui/UiExtensions.kt already covers the call pattern.ConfigurationHelper, ThemeHelper, or
AniTrendTheme3 already owns it.NotificationHelper or
NotificationExtensions.kt already models the behavior.:app:navigation, :android:navigation, or :android:deeplink already owns the route.:android:*; keep feature-specific logic in the owning feature.android/core/src/main/kotlin/co/anitrend/android/core/koin/Modules.ktandroid/core/src/main/kotlin/co/anitrend/android/core/settings/helper/config/ConfigurationHelper.ktandroid/core/src/main/kotlin/co/anitrend/android/core/extensions/ContextExtensions.ktandroid/core/src/main/kotlin/co/anitrend/android/core/helpers/notification/NotificationExtensions.ktandroid/core/src/main/kotlin/co/anitrend/android/core/ui/theme/Theme.ktandroid/navigation/src/main/kotlin/co/anitrend/android/navigation/drawer/koin/Modules.ktandroid/navigation/src/main/kotlin/co/anitrend/android/navigation/drawer/provider/FeatureProvider.ktandroid/deeplink/src/main/kotlin/co/anitrend/android/deeplink/koin/Modules.ktandroid/deeplink/src/main/kotlin/co/anitrend/android/deeplink/component/screen/DeepLinkScreen.ktandroid/deeplink/src/main/kotlin/co/anitrend/android/deeplink/provider/FeatureProvider.ktapp/core/src/main/kotlin/co/anitrend/core/koin/Modules.ktapp/core/src/main/kotlin/co/anitrend/core/ui/UiExtensions.ktapp/src/main/kotlin/co/anitrend/component/screen/MainScreen.kt