android-platform-patterns

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.

Skill: Android Platform Patterns

Overview

: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 helpers

Use the concrete anchors in the layer example matrix when you need a real code path to copy.

Module roles

• :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.

Reuse-first workflow

1. Search android/core, android/navigation, android/deeplink, and app/core before creating anything new.
2. If an existing helper/controller/provider already models the behavior, extend that surface in place instead of cloning the API in feature, common, or task.
3. If the behavior is app-shell specific, inspect android/navigation/src/main/kotlin/co/anitrend/android/navigation/ and app/src/main/kotlin/co/anitrend/component/screen/MainScreen.kt.
4. If the behavior starts from an external URI, inspect android/deeplink before touching a feature module.
5. Only add a new internal API when reuse would break ownership boundaries or force an awkward abstraction that is less clear than a new platform-local helper.

Decision rules

• Do not recreate context or fragment lookup helpers if 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.
• Do not recreate theme or configuration wiring if ConfigurationHelper, ThemeHelper, or AniTrendTheme3 already owns it.
• Do not recreate notification permission or settings flows if NotificationHelper or NotificationExtensions.kt already models the behavior.
• Do not bypass router and provider contracts with direct intent construction when :app:navigation, :android:navigation, or :android:deeplink already owns the route.
• Keep platform-wide helpers in :android:*; keep feature-specific logic in the owning feature.

Canonical files

• android/core/src/main/kotlin/co/anitrend/android/core/koin/Modules.kt
• android/core/src/main/kotlin/co/anitrend/android/core/settings/helper/config/ConfigurationHelper.kt
• android/core/src/main/kotlin/co/anitrend/android/core/extensions/ContextExtensions.kt
• android/core/src/main/kotlin/co/anitrend/android/core/helpers/notification/NotificationExtensions.kt
• android/core/src/main/kotlin/co/anitrend/android/core/ui/theme/Theme.kt
• android/navigation/src/main/kotlin/co/anitrend/android/navigation/drawer/koin/Modules.kt
• android/navigation/src/main/kotlin/co/anitrend/android/navigation/drawer/provider/FeatureProvider.kt
• android/deeplink/src/main/kotlin/co/anitrend/android/deeplink/koin/Modules.kt
• android/deeplink/src/main/kotlin/co/anitrend/android/deeplink/component/screen/DeepLinkScreen.kt
• android/deeplink/src/main/kotlin/co/anitrend/android/deeplink/provider/FeatureProvider.kt
• app/core/src/main/kotlin/co/anitrend/core/koin/Modules.kt
• app/core/src/main/kotlin/co/anitrend/core/ui/UiExtensions.kt
• app/src/main/kotlin/co/anitrend/component/screen/MainScreen.kt