Decompose Claude Code Plugin
A Claude Code plugin that provides production best practices for Decompose — the Kotlin Multiplatform library for navigation and component lifecycle management.
What You Get
- 1 slash command for scanning and fixing Decompose setup across all platforms
- 3 auto-invoked skills that activate automatically when Claude detects you're working with Decompose
- A
CLAUDE.md template to paste into any Decompose project for always-on guidance
Installation
Step 1 — Add this repo as a marketplace
In a Claude Code session, run:
/plugin marketplace add Litun/DecomposeClaudePlugin
Step 2 — Install the plugin
/plugin install decompose@Litun-DecomposeClaudePlugin
Or browse via /plugin → Discover and install from there.
Step 3 — Add CLAUDE.md to your project (optional but recommended)
Copy the contents of CLAUDE.md into your project's CLAUDE.md. This gives Claude baseline Decompose context in every conversation — no skill invocation needed.
Usage
Slash commands (explicit)
Invoke any command when you need deep guidance on a specific topic:
/decompose:setup
Auto-invoked skills (automatic)
Claude detects Decompose context and loads the right skill automatically. For example:
- You write
class DefaultXxxComponent(componentContext: ComponentContext) → decompose-component activates
- You ask "should I use ChildStack or ChildSlot for this dialog?" →
decompose-navigation activates
- You ask "how do I observe state in Compose?" →
decompose-compose activates
Skill Coverage
decompose-component
interface + DefaultXxxComponent patternComponentContext by componentContext delegationValue<T> / MutableValue<T> observable stateretainedInstance { } — ViewModel equivalentsaveable(serializer = ...) — process death survival- Lifecycle events (
doOnStart, doOnStop, doOnDestroy)
- Custom back button handling
- Preview / test double patterns
decompose-navigation
- Decision table: when to use Stack vs Slot vs Pages vs Panels vs Items
- Configuration requirements (
@Serializable, immutable, size limits)
- Full
ChildStack example with push, pop, bringToFront, popTo, result delivery
ChildSlot for dialogs/modalsChildPages for pagersChildPanels for responsive master-detail- Multiple navigation models with distinct keys
- Deep linking via
initialStack
decompose-compose
subscribeAsState() — Value<T> → Compose State<T>Children() composable with stackAnimation(fade() + scale())predictiveBackAnimation() for Android 13+ChildPages() composableChildPanels() with HorizontalChildPanelsLayout- Tab bottom bar pattern
LifecycleController for Desktop- Compose previews with fake component implementations
- Back handling with
BackCallback (vs Jetpack BackHandler)
Links
Litun