compose-performance

Purpose

Diagnose and fix measurable Compose performance issues without guessing.

When to use

• A screen scrolls poorly or drops frames.
• Recomposition counts spike unexpectedly.
• Lazy lists, side effects or state reads are suspected performance causes.
• Baseline profiles, tracing or performance CI are needed.

Inputs to inspect

• Affected composables and state models.
• Profiler, compiler report or benchmark evidence if available.
• Lazy list item models and keys.
• Build variants and benchmark tasks.

Required workflow

1. Reproduce or describe the performance symptom.
2. Inspect state reads, stability, keys and side effects.
3. Apply the smallest targeted fix.
4. Measure again with available tools.
5. Document residual risks and validation gaps.

Rules

• Measure before large rewrites.
• Do not add remember everywhere blindly.
• Do not use @Stable/@Immutable unless the contract is true.
• Use stable lazy keys and content types when needed.
• Prefer release-mode measurement for meaningful performance claims.

Related existing skills

Local skills to invoke

• jetpack-compose
• macrobenchmark-baseline-profiles
• screen-ux-audit
• testing

External companion skills to use when installed

Do not assume these companion skills are installed. Prefer the local skills above first, then consult Companion Skills for install and verification commands.

• aldefy/compose-skill — use for deeper Jetpack Compose, Material 3, design-to-code, theming or Compose architecture guidance.
• skydoves/compose-performance-skills — use for deeper Compose performance, recomposition, stability or release-mode measurement guidance.

Files commonly touched

• Compose screens
• UI models
• benchmark module
• baseline-prof.txt
• build.gradle.kts

Commands to validate

./gradlew assembleRelease
./gradlew connectedBenchmarkAndroidTest
./gradlew test
adb shell am profile start

Common mistakes to avoid

• Optimizing from intuition only.
• Ignoring image size/loading.
• Using unstable mutable models as parameters.
• Missing lazy item keys.