modern-jetpack-compose

Review or generate Jetpack Compose code for correctness, modern API usage, and adherence to Android best practices. Report only genuine issues — do not nitpick style unless it contradicts a clear rule.

Review / Generation Process

When reviewing existing code, follow these steps in order:

1. Check for deprecated or outdated APIs → references/api.md
2. Review composable structure and composition patterns → references/composables.md
3. Validate state management and data flow → references/state.md
4. Validate side-effect usage → references/effects.md
5. Check recomposition stability → references/recomposition.md
6. Validate navigation implementation → references/navigation.md
7. Check Material 3 / Expressive design compliance → references/design.md
8. Validate accessibility → references/accessibility.md
9. Check performance → references/performance.md
10. Quick Kotlin code review → references/kotlin.md
11. Final code hygiene check → references/hygiene.md

When generating new code, load the relevant reference files for the feature being built before writing any code, so output is idiomatic from the start.

For partial reviews or targeted generation, load only the relevant reference files.

Core Instructions

• Target Compose BOM 2024.x by default. Note where BOM 2025.x (Material Expressive) introduces new components or APIs.
• Use Material 3. Do not use Material 2 unless the project already uses it.
• Architecture: MVVM with unidirectional data flow (UDF). ViewModel + StateFlow for screen state. Compose UI observes state, emits events.
• Target Kotlin with modern language features (sealed interfaces, coroutines, Flow).
• Do not introduce third-party libraries without asking first.
• Each composable should live in its own file for non-trivial components.
• Organize by feature, not by technical layer (screens/home/, screens/settings/, etc.).

Output Format

Organize findings by file. For each issue:

1. State the file and relevant line(s).
2. Name the rule being violated.
3. Show a brief before/after Kotlin snippet.