Skip to content

aldefy/compose-skill / skills/compose-expert

compose-expert

Unverified

Compose and Compose Multiplatform expert for UI development across Android, Desktop, iOS, and Web. Use whenever the user mentions Compose APIs (@Composable, remember, LaunchedEffect, NavHost, MaterialTheme, LazyColumn, Modifier, recomposition), Compose Multiplatform (commonMain, expect/actual, Res.*, ComposeUIViewController, UIKitView, ComposeViewport), Android TV (tv-material, D-pad, focus, Carousel), Material 3 motion, atomic design systems, design-to-code workflows, Paging 3, or navigation. Activates Review Mode on GitHub PR URLs and review phrases ("review this PR", "what's wrong with this"). Auto-detects Compose projects on session_start. Backed by actual androidx/androidx and JetBrains/compose-multiplatform-core source receipts. See "## When this skill applies" in SKILL.md for the full trigger surface.

FileKindSize
SKILL.mdskill md24.8 KB
agents/openai.yamlconfig278 B
references/accessibility.mdmarkdown11.2 KB
references/adaptive-layout-input.mdmarkdown5.2 KB
references/agentic-ui-a2ui.mdmarkdown4.7 KB
references/agsl-shaders.mdmarkdown11.5 KB
references/animation.mdmarkdown41.7 KB
references/appfunctions.mdmarkdown5.8 KB
references/appstate.mdmarkdown3.9 KB
references/atomic-design.mdmarkdown10.7 KB
references/auto-init.mdmarkdown1.6 KB
references/car-compose.mdmarkdown6.7 KB
references/composition-locals.mdmarkdown6.9 KB
references/deprecated-patterns.mdmarkdown8.3 KB
references/design-to-compose.mdmarkdown23.5 KB
references/graphics-modern.mdmarkdown2.6 KB
references/ink.mdmarkdown5.1 KB
references/lists-scrolling.mdmarkdown14.5 KB
references/material3-motion.mdmarkdown14.9 KB
references/media3-compose.mdmarkdown1.7 KB
references/ml-kit-agentic.mdmarkdown5.5 KB
references/modifiers.mdmarkdown13.6 KB
references/multiplatform.mdmarkdown21.1 KB
references/navigation-migration.mdmarkdown14.6 KB
references/navigation.mdmarkdown11.0 KB
references/official-android-skills.mdmarkdown2.7 KB
references/paging-mvi-testing.mdmarkdown6.4 KB
references/paging-offline.mdmarkdown6.4 KB
references/paging.mdmarkdown11.1 KB
references/performance.mdmarkdown22.7 KB
references/platform-specifics.mdmarkdown20.2 KB
references/pr-review.mdmarkdown14.1 KB
references/production-crash-playbook.mdmarkdown25.3 KB
references/remote-compose.mdmarkdown3.7 KB
references/side-effects.mdmarkdown13.0 KB
references/source-code/cmp-source.mdmarkdown17.8 KB
references/source-code/foundation-source.mdmarkdown560.9 KB
references/source-code/material3-source.mdmarkdown836.1 KB
references/source-code/navigation-source.mdmarkdown118.8 KB
references/source-code/runtime-source.mdmarkdown449.0 KB
references/source-code/ui-source.mdmarkdown313.1 KB
references/state-management.mdmarkdown17.6 KB
references/styles-experimental.mdmarkdown14.5 KB
references/text-editing.mdmarkdown3.8 KB
references/theming-material3.mdmarkdown13.0 KB
references/tv-compose.mdmarkdown30.2 KB
references/view-composition.mdmarkdown20.0 KB
references/wear-compose.mdmarkdown2.0 KB
references/xr-compose.mdmarkdown5.1 KB

references/deprecated-patterns.md

View on GitHub
# Deprecated Patterns & API Migrations in Jetpack Compose

This guide covers major API changes and deprecations in Compose's evolution. Each section shows the old pattern → new approach with migration notes.

---

## String-Based Routes → Type-Safe `@Serializable` Routes

**Old (pre-2.8):**
```kotlin
NavHost(navController, startDestination = "home") {
    composable("home") { HomeScreen() }
    composable("details/{id}") { backStackEntry ->
        DetailsScreen(id = backStackEntry.arguments?.getString("id"))
    }
}
```

**New (Navigation 2.8+):**
```kotlin
@Serializable data class Home
@Serializable data class Details(val id: String)

NavHost(navController, startDestination = Home) {
    composable<Home> { HomeScreen() }
    composable<Details> { backStackEntry ->
        val args: Details = backStackEntry.toRoute()
        DetailsScreen(id = args.id)
    }
}
```

**Migration notes:** Type-safe routes eliminate string typos and runtime crashes. Requires `kotlinx-serialization` plugin and `navigation-compose:2.8.0+`. Encode complex objects using custom serializers.

---

## `accompanist-systemuicontroller` → `enableEdgeToEdge()`

**Old:**
```kotlin
val systemUiController = rememberSystemUiController()
systemUiController.setSystemBarsColor(
    color = Color.Transparent,
    darkIcons = false
)
```

**New (Compose 1.7+):**
```kotlin
enableEdgeToEdge()
// In Activity.onCreate() before setContent {}
```

**Migration notes:** Built-in since Compose 1.7. Automatically handles status bar, navigation bar, and IME behind content. Remove `accompanist-systemuicontroller` dependency entirely.

---

## `accompanist-pager` → `HorizontalPager`/`VerticalPager`

**Old:**
```kotlin
val pagerState = rememberPagerState()
HorizontalPager(count = items.size, state = pagerState) { page ->
    PageContent(items[page])
}
```

**New (Foundation):**
```kotlin
val pagerState = rememberPagerState(pageCount = { items.size })
HorizontalPager(state = pagerState) { page ->
    PageContent(items[page])
}
```

**Migration notes:** Native Pager in `foundation:1.6+` replaces accompanist. Removes external dependency. State initialization slightly different; pass lambda for dynamic page counts.

---

## `accompanist-swiperefresh` → `PullToRefreshBox`

**Old:**
```kotlin
SwipeRefresh(state = rememberSwipeRefreshState(isRefreshing), onRefresh = { load() }) {
    LazyColumn { items(data) { item -> ItemRow(item) } }
}
```

**New (Material3):**
```kotlin
PullToRefreshBox(isRefreshing = isRefreshing, onRefresh = { load() }) {
    LazyColumn { items(data) { item -> ItemRow(item) } }
}
```

**Migration notes:** `PullToRefreshBox` in `material3:1.2+` is the official replacement. Cleaner API. Remove `accompanist-swiperefresh` dependency.

---

## `accompanist-flowlayout` → `FlowRow`/`FlowColumn`

**Old:**
```kotlin
FlowRow(mainAxisSize = SizeMode.Expand) {
    items.forEach { item -> Chip(text = item) }
}
```

**New (Foundation):**
```kotlin
FlowRow(modifier = Modifier.fillMaxWidth()) {
    items.forEach { item -> Chip(text = item) }
}
```

**Migration notes:** FlowRow/FlowColumn in `foundation:1.6+`. API simplified; use standard modifiers instead of `SizeMode`. Better performance and less memory overhead.

---

## `LazyColumn { animateItemPlacement() }` → `LazyColumn { animateItem() }`

**Old:**
```kotlin
LazyColumn {
    items(items, key = { it.id }) { item ->
        ItemRow(item.name, Modifier.animateItemPlacement())
    }
}
```

**New:**
```kotlin
LazyColumn {
    items(items, key = { it.id }) { item ->
        ItemRow(item.name, Modifier.animateItem())
    }
}
```

**Migration notes:** `animateItem()` is the modern API (Compose 1.7+). Returns animation state for finer control. `animateItemPlacement()` still works but is superseded.

---

## `Modifier.composed` Pattern → `Modifier.Node` API

**Old:**
```kotlin
fun Modifier.myModifier(value: Int) = composed {
    val state = remember { mutableStateOf(value) }
    Modifier.fillMaxWidth().padding(8.dp)
}
```

**New:**
```kotlin
fun Modifier.myModifier(value: Int) = this.then(
    Modifier
        .fillMaxWidth()
        .padding(8.dp)
)
// Or for complex state:
class MyModifierNode(val value: Int) : ModifierNodeElement<MyNodeImpl>() {
    override fun create() = MyNodeImpl(value)
    override fun update(node: MyNodeImpl) { node.value = value }
}
private class MyNodeImpl(var value: Int) : Modifier.Node
```

**Migration notes:** `composed {}` incurs overhead; avoid if no `remember` calls needed. For stateful modifiers, prefer `ModifierNode` API (Compose 1.8+). Benchmark before migrating existing code.

---

## Primitive State Optimization: `mutableStateOf(0)` → `mutableIntStateOf(0)`

**Old:**
```kotlin
var count by remember { mutableStateOf(0) }
var temperature by remember { mutableStateOf(37.5f) }
```

**New:**
```kotlin
var count by remember { mutableIntStateOf(0) }
var temperature by remember { mutableFloatStateOf(37.5f) }
```

**Migration notes:** Primitive-specific functions (`mutableIntStateOf`, `mutableFloatStateOf`, `mutableLongStateOf`) avoid boxing. Negligible performance impact in UI code but best practice since Compose 1.4+.

---

## `collectAsState()` → `collectAsStateWithLifecycle()`

**Old:**
```kotlin
val state by viewModel.uiState.collectAsState()
```

**New:**
```kotlin
val state by viewModel.uiState.collectAsStateWithLifecycle()
```

**Migration notes:** `collectAsStateWithLifecycle()` (Compose 1.6+) respects lifecycle—automatically stops collecting when activity is paused. Prevents memory leaks and redundant work. Requires `androidx.lifecycle:lifecycle-runtime-compose`.

---

## `@ExperimentalMaterial3Api` Graduation

**Old:**
```kotlin
@OptIn(ExperimentalMaterial3Api::class)
fun MyScreen() {
    DatePicker(state = rememberDatePickerState())
}
```

**New (Compose 1.8+, Material3 1.3+):**
```kotlin
fun MyScreen() {
    DatePicker(state = rememberDatePickerState())
}
```

**Migration notes:** DatePicker, TimePicker, ExposedDropdownMenuBox, and SearchBar graduated to stable in Material3 1.3+. Remove `@OptIn` annotations. APIs are stable—safe for production use.

---

## `Scaffold` Padding Enforcement

**Old (problematic):**
```kotlin
Scaffold(topBar = { TopAppBar() }) {
    LazyColumn { items(data) { item -> ItemRow(item) } }
}
```

**New (required since 1.6+):**
```kotlin
Scaffold(topBar = { TopAppBar() }) { innerPadding ->
    LazyColumn(modifier = Modifier.padding(innerPadding)) {
        items(data) { item -> ItemRow(item) }
    }
}
```

**Migration notes:** Must use `innerPadding` parameter since Compose 1.6. Ignoring it causes content overlap under system bars. The compiler enforces this now—old pattern won't compile.

---

## Material 2 → Material 3 Migration

**Old (Material):**
```kotlin
Button(onClick = { }) { Text("Click") }
TextField(value = text, onValueChange = { text = it })
Surface(color = MaterialTheme.colors.primary) { /* */ }
```

**New (Material3):**
```kotlin
Button(onClick = { }) { Text("Click") }  // Same signature
TextField(value = text, onValueChange = { text = it })  // Same signature
Surface(color = MaterialTheme.colorScheme.primary) { /* */ }
```

**Migration notes:** Most Composables are API-compatible. Main changes: `colors` → `colorScheme`, new shape system, updated ripple defaults. Use Compose BOM to align Material3 versions.

---

## `WindowInsets` & Edge-to-Edge

**Old:**
```kotlin
Surface(modifier = Modifier.systemBarsPadding()) { /* */ }
```

**New (API 35+ default edge-to-edge):**
```kotlin
Surface(modifier = Modifier.padding(WindowInsets.systemBars.asPaddingValues())) { /* */ }
// Or use enableEdgeToEdge() in Activity—handles automatically
```

**Migration notes:** Edge-to-edge is default on Android 15+. System bar colors are managed by `enableEdgeToEdge()`. Use `WindowInsets.safeDrawing` for notch-aware layouts. Deprecate manual `systemBarsPadding()` calls.

---

## `ObservableState` Pattern Changes

**Old:**
```kotlin
@Composable
fun observe(state: ObservableState): State<T> = produceState(state.value) {
    state.onChange { value = it }
}
```

**New:**
```kotlin
@Composable
fun <T> ObservableState<T>.asState(): State<T> = produceState(this.value) {
    snapshotFlow { value }.collect { value = it }
}
```

**Migration notes:** `snapshotFlow {}` is preferred over direct listeners (Compose 1.6+). Integrates better with Compose's snapshot system. Use `distinctUntilChanged()` to avoid redundant recompositions.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 197kUpdated Claude CodeCodexVerifiedInstall