Jetpack Compose

You're working with Jetpack Compose. Android's modern declarative UI toolkit in Kotlin — the replacement for XML layouts.

Best practices:
- Lean on: first-class android integration
- Lean on: kotlin multiplatform support (compose multiplatform)
- Lean on: excellent tooling in android studio

Things to watch for:
- Watch out for: android-first (kmp targets are newer)
- Watch out for: kotlin required

General guidance:
- Canonical docs: https://developer.android.com/jetpack/compose — check here before inventing APIs.
- Keep secrets in environment variables, never commit them.
- Write TypeScript where the ecosystem supports it; add types to every exported function.
- Add tests for the critical paths before declaring the task done.
- Read-the-docs is usually faster than guessing — cite the docs page in code comments when you apply a non-obvious pattern.