jetpack-compose-m3

To migrate Wear OS Compose from Material 2.5 or Horologist to Material3, align your androidx.wear.compose.material3 dependencies and replace UI components. This process uses a phased, version-aware migration plan with specific dependency alignment and UI behavior expectations.

Building Wear OS apps with Compose Material3 requires Kotlin 2.0+ and a minimum SDK of 25. You must also validate Gradle sync and extract official component samples from the Wear Compose samples JARs before implementing code changes.

Using AppScaffold, ScreenScaffold, and TransformingLazyColumn in Wear OS Material3 requires specific parameters, scoped modifiers, and correct scrolling/navigation patterns. A component correctness checklist ensures proper implementation and prevents misuses across versions.

Wear OS Compose Material3 supports navigation3 patterns through the androidx.wear.compose.navigation3 library. Correct implementation involves using core scaffold navigation patterns and validating component behavior with official samples.

Breaking changes during Wear OS Compose Material3 migration often stem from misuses across versions and misaligned dependencies. Extracting official component samples and enforcing a version-matched implementation plan prevents these breaking changes.