android-architecture

name	Android Architecture
description	Standards for Clean Architecture, Modularization, and Unidirectional Data Flow
metadata	{"labels":["android","architecture","clean-architecture","mvvm"],"triggers":{"files":["build.gradle.kts","settings.gradle.kts"],"keywords":["clean-architecture","module","layers","domain"]}}

Android Architecture Standards

Priority: P0

Implementation Guidelines

Layering (Clean Architecture)

• Domain: Pure Kotlin (No Android deps). Contains UseCases/Models.
• Data: Repository impl, DataSources (API/DB). Maps DTO -> Domain.
• UI: ViewModel + Composable. Maps Domain -> UiState.

Modularization

• Feature Modules: :feature:home, :feature:profile.
• Core Modules: :core:ui (Design System), :core:network, :core:database.
• App Module: DI Root and Navigation Guard.

Unidirectional Data Flow (UDF)

• Events: UI -> ViewModel (Events).
• State: ViewModel -> UI (StateFlow).

Anti-Patterns

• God Activity: **No Logic in/Activity**: Host Navigation only.
• Direct Repos: **No Repo in UI**: Use Type-Safe ViewModels.
• Android in Domain: **No Context in Domain**: Keep Logic Pure.

References

• Structure & Examples