v2.4.0

What changed

Added

• Executable Compose layout claim CI. Added a verify-claims Android library module that harvests ```kotlin verify blocks from reference docs, generates Robolectric Compose tests, and asserts measured width/height claims on the JVM. The .size(100.dp).padding(16.dp) modifier-footprint claim is now covered by an executable test.
• Opt-in snippet compile checks. Reference docs can now mark self-contained snippets with ```kotlin compile so CI compiles them without requiring a measured layout assertion. This catches stale or hallucinated APIs while leaving illustrative fragments alone.
• Downloadable verify-claims reports. The verify-claims CI job now uploads a verify-claims-report artifact on every run, including failures. It contains the Gradle HTML test report and JUnit XML.
• Material 3 Expressive coverage. Expanded references/theming-material3.md and references/material3-motion.md with MaterialExpressiveTheme, expressive component families, expressive motion guidance, and experimental API caveats.
• Advanced Navigation 3 patterns. Expanded references/navigation-migration.md with result passing, auth-gated navigation, animated/shared-element transitions, adaptive list-detail, and per-tab back stacks.

CI / Tooling

• Added Gradle/Robolectric-based Compose claim verification to GitHub Actions.
• Added generated compile-only subjects for opt-in kotlin compile markdown blocks.
• Broadened reference scanning to all top-level skills/compose-expert/references/*.md files.
• Uploaded verify-claims/build/reports/tests/testDebugUnitTest/ and verify-claims/build/test-results/testDebugUnitTest/ as the verify-claims-report artifact.

Release

• Bumped the plugin from 2.3.2 to 2.4.0 across the Claude manifest, Copilot manifest, SKILL.md, changelog, and tag.

Install / Update

• Claude Code: /plugin update compose-expert
• Copilot CLI: copilot plugin update aldefy/compose-skill
• Codex CLI: git pull in your cloned skills dir

Report artifact

For future CI runs: open the Actions run, scroll to Artifacts, and download verify-claims-report.

v2.3.1

Install / Update

• Claude Code: /plugin update compose-expert
• Copilot CLI: copilot plugin update aldefy/compose-skill
• Codex CLI: git pull in your cloned skills dir

---

v2.3.0

Install / Update

• Claude Code: /plugin update compose-expert
• Copilot CLI: copilot plugin update aldefy/compose-skill
• Codex CLI: git pull in your cloned skills dir

---

v2.1.2

Install / Update

• Claude Code: /plugin update compose-expert
• Copilot CLI: copilot plugin update aldefy/compose-skill
• Codex CLI: git pull in your cloned skills dir

---

v2.1.1

Install / Update

• Claude Code: /plugin update compose-expert
• Copilot CLI: copilot plugin update aldefy/compose-skill
• Codex CLI: git pull in your cloned skills dir

---

v2.1.0

Install / Update

• Claude Code: /plugin update compose-expert
• Copilot CLI: copilot plugin update aldefy/compose-skill
• Codex CLI: git pull in your cloned skills dir

---

v2.0.0 — Compose Multiplatform, Design-to-Code, Production Crash Playbook

What's New

Compose Multiplatform Support

• CMP architecture guide with API availability matrix across Android, Desktop, iOS, and Web
• expect/actual patterns from real compose-multiplatform-core source
• Resource system (Res.*) guide with gotchas
• Migration guide from Android-only to CMP
• Platform-specifics: Desktop (Window, Tray, MenuBar, Swing interop), iOS (UIKitView, lifecycle gotchas, binary size), Web/WASM (canvas limitations)
• CMP source code receipts with actual API signatures

Design-to-Code Engine

• Composable decomposition algorithm (based on DCGen, ACM SIGSOFT 2025)
• Figma-to-Compose property mapping tables (layout, sizing, spacing, shadows, gradients, corners, opacity)
• Design token → MaterialTheme mapping
• Modifier ordering rules (the #1 source of bugs in AI-generated Compose)
• Spacing ownership principle: parent owns spacing

Production Crash Playbook

• 6 crash patterns with root cause and fix: remember without config key, indexOf() in items, zero-size DrawScope, duplicate LazyColumn keys, derivedStateOf driving collection size, collectAsState lifecycle
• Defensive patterns: SafeShimmerItem, multi-field collision prefix keys, dedupIndex
• Production state rules and performance rules

Animation Guide (3x larger)

• 9 recipes: shimmer, staggered list entrance, swipe-to-dismiss, expandable card, pull-to-refresh, FAB morph, bottom sheet drag, parallax header, animated tabs
• Animation decision tree: which API for which scenario
• Gesture-driven patterns: swipe-to-dismiss with Animatable, AnchoredDraggable, transformable
• Design-to-animation translation: Figma easing curves → Compose, M3 motion tokens, spring parameter intuition, Figma spring conversion formula
• Predictive back gesture animation (Android 14+)
• Sequential/parallel animation choreography

Updated Guides

• State management: produceState, rememberUpdatedState, sealed UiState pattern, state holder class, CMP state notes
• Lists/scrolling: crash patterns, collision prefix keys, ReportDrawnWhen, device-specific pagination
• View composition: 5-step decomposition methodology, Scaffold patterns, composite preview annotations, adaptive layouts
• Performance: zero-size guard, composition tracing, movableContentOf, compiler report flags, CMP performance notes

Fixes

• Shared element transition code now uses correct SharedTransitionLayout API
• CompositionLocal explanation corrected (staticCompositionLocalOf invalidates entire subtree)
• Removed incorrect accompanist-permissions deprecation claim (PR #1 by @Daiji256)

Stats

• 17 reference guides (was 13)
• 6 source code files (was 5)
• 5,142 lines added

v1.1.0 — Styles API + Setup Fixes

What's new

Added

• Styles API (experimental) reference guide — covers Style {}, MutableStyleState, Modifier.styleable(), composition, theme integration, and alpha06 gotchas

Fixed

• Claude Code setup: replaced non-existent claude skill add CLI command with correct file-based ~/.claude/skills/ and .claude/skills/ approach
• Codex CLI setup: removed non-existent --instructions flag, now uses AGENTS.md only
• Windsurf setup: updated from legacy .windsurfrules to current .windsurf/rules/*.md approach

Housekeeping

• Swapped logo to MIT-licensed devicon SVG
• Added CHANGELOG.md

---

Full changelog: a8b2a59...v1.1.0

If you forked this repo, use GitHub's Sync fork button or git pull upstream master to get these updates.