jetpack-compose-m3

Enforce compatible Wear OS Compose Material3 library and compiler configurations.

174|8|Updated Jan 9, 2024
One-click install
npx skills add https://github.com/klxiaoniu/QQVersionList --skill jetpack-compose-m3-klxiaoniu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jetpack-compose-m3
Source: https://github.com/klxiaoniu/QQVersionList/tree/main/.agents/skills/jetpack-compose-m3
Command: npx skills add https://github.com/klxiaoniu/QQVersionList --skill jetpack-compose-m3-klxiaoniu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill prevents breaking changes when migrating Wear OS apps to Compose Material 3 by enforcing compatible dependency versions, Kotlin/Compose compiler rules, and safe component usage patterns.

Core Features & Use Cases

  • Wear OS Material3 migration guidance: Walks you through moving from Material 2.5 and Horologist to androidx.wear.compose.material3 with correct component mapping and expectations for updated UI defaults.
  • Version-accurate component sample usage: Requires extracting and reading official component samples from the *-samples-sources.jar artifacts before implementing or refactoring UI code.
  • TransformingLazyColumn best-practice checklist: Ensures the correct use of ScreenScaffold + TransformingLazyColumn, including required imports, padding forwarding, transformed height usage, and snapping behavior.
  • Common gotchas and guardrails: Mandates Gradle sync after version updates and prohibits “guessing fixes” via downgrades when unresolved references appear after a successful sync.

Quick Start

Tell the AI: “Migrate my Wear OS Compose code from Material 2.5 (and any Horologist usage) to Material3, using TransformingLazyColumn inside ScreenScaffold, and ensure I first extract and read the official component samples for the latest stable compose-material3 version.”

Frequently Asked Questions about jetpack-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 safely?

Migrate Wear OS Compose to Material3 by enforcing compatible library versions, Kotlin/Compose compiler rules, and mapping Horologist components to `androidx.wear.compose.material3` while validating Gradle sync.

What is the correct way to implement TransformingLazyColumn in Wear OS Material3?

Implement TransformingLazyColumn by placing it inside ScreenScaffold, forwarding padding correctly, using transformed height, and verifying snapping behavior against the component-specific checklist compliance rules.

Why do I get unresolved reference errors after updating to Compose Material3?

Unresolved reference errors after updating to Compose Material3 require a mandatory Gradle sync validation. Prohibit guessing fixes via dependency downgrades if references remain unresolved post-sync.

Where can I find official Wear OS Material3 component samples for AppScaffold?

Find official Wear OS Material3 component samples by strictly extracting and reading the version-matched `*-samples-sources.jar` artifacts before implementing or refactoring AppScaffold UI code.

Can I use Horologist components directly with AndroidX Wear Compose Material3?

Migrating from Horologist requires mapping to `androidx.wear.compose.material3` components and enforcing compatible library versions to prevent breaking changes and ensure correct UI defaults.