wear-compose-m3

Guides creation and migration of Wear OS apps using Compose Material3 libraries.

3|Updated Aug 4, 2024
One-click install
npx skills add https://github.com/kabindra-shrestha/Clean-Architecture-Kotlin-Compose-Multiplatform --skill wear-compose-m3-kabindra-shrestha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wear-compose-m3
Source: https://github.com/kabindra-shrestha/Clean-Architecture-Kotlin-Compose-Multiplatform/tree/main/.agents/skills/wear/wear-compose-m3
Command: npx skills add https://github.com/kabindra-shrestha/Clean-Architecture-Kotlin-Compose-Multiplatform --skill wear-compose-m3-kabindra-shrestha

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Wear OS developers working with Compose Material3 face version confusion, breaking API changes from Material 2.5 and Horologist, and component misuse that leads to incorrect layouts on round watch screens. ## Core Features & Use Cases - Version Resolution: Determines the latest stable androidx.wear.compose:compose-material3 version from Google Maven metadata and enforces Kotlin 2.0+ and minSdk 25 requirements. - Migration Guidance: Maps Material 2.5 and Horologist components to Material 3 equivalents using the official migration reference, including theme, color, typography, and shape changes. - Canonical Component Samples: Downloads and extracts the official -samples-sources.jar files into a local cache so implementations match version-specific component APIs. - Component Checklists: Provides usage rules for AppScaffold, ScreenScaffold, TransformingLazyColumn, EdgeButton, and Navigation3. - Use Case: When migrating a Wear OS app from Horologist to Material3, the skill syncs Gradle, extracts official samples, and refactors ScalingLazyColumn to TransformingLazyColumn with correct transformation specs. ## Quick Start Ask the assistant to migrate your Wear OS screen from Material 2.5 to Compose Material3 using the latest stable library version.

Frequently Asked Questions about wear-compose-m3

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate Wear OS Compose from Material 2.5 to Material3?

Update dependencies to androidx.wear.compose:compose-material3, perform a Gradle sync, then follow the official component mapping guide. Replace Horologist components with Material3 equivalents and adopt the new ColorScheme, Typography, and MotionScheme theme parameters.

How do I use TransformingLazyColumn in Wear Compose Material3?

TransformingLazyColumn replaces ScalingLazyColumn and requires rememberTransformingLazyColumnState plus rememberTransformationSpec. Pass the contentPadding from ScreenScaffold and apply transformedHeight and SurfaceTransformation modifiers to list items.

What Kotlin version does Wear Compose Material3 require?

Wear Compose Material3 requires Kotlin 2.0.0 or higher with the org.jetbrains.kotlin.plugin.compose Gradle plugin. Older Kotlin versions must use kotlinCompilerExtensionVersion matching the Compose to Kotlin compatibility map.

Can I use Horologist libraries with Wear Compose Material3?

No, the migration guidance explicitly prohibits using Horologist Composables, Compose Layout, or Compose Material libraries with Material3. All equivalent functionality should come from androidx.wear.compose.material3 components.

Why do I get unresolved reference errors after updating Wear Compose versions?

Unresolved references usually mean the Gradle sync has not completed or samples have not been extracted. Do not downgrade the library version; sync the project first, then consult the official samples-sources JAR for correct API usage.

What is the minimum SDK for Wear Compose Material3?

The minimum SDK is 25, corresponding to Wear OS 2.0. Ensure your project's minSdk is set to at least 25 before adding the compose-material3 dependency.