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/ink.md

View on GitHub
# Jetpack Ink in Compose

> Jetpack Ink (`androidx.ink`) is Android-first. `1.0.0` is stable (2025-12-17);
> the `1.1.0-alpha` line (alpha11 on 2026-11-04) adds experimental APIs. Pin one
> version for all `ink-*` artifacts and gate alpha-only APIs explicitly.

Ink is a modular library for creating, rendering, storing, and editing
pen/stylus strokes. Use it instead of hand-rolling a `Canvas` + `Path` drawing
surface when you need low-latency wet ink, pressure/tilt-aware brushes,
serialization, or stroke-aware erasing and selection.

## Modules

| Module | Responsibility |
|---|---|
| `ink-authoring` / `ink-authoring-compose` | Real-time stroke input, `InProgressStrokesView`, low-latency rendering while the pen is down |
| `ink-brush` / `ink-brush-compose` | `Brush`, `BrushFamily`, `StockBrushes`, custom brush behavior |
| `ink-strokes` | Finished `Stroke` data, `StrokeInputBatch` |
| `ink-rendering` | `CanvasStrokeRenderer`, `ViewStrokeRenderer` for finished strokes |
| `ink-geometry` / `ink-geometry-compose` | Intersection, coverage, `PartitionedMesh` for hit-testing, selection, erasing |
| `ink-storage` | Serialization of strokes and brushes |
| `ink-nativeloader` | Loads Ink's native (JNI) code |

Depend only on the modules you use, all at the same version:

```kotlin
dependencies {
    implementation("androidx.ink:ink-authoring-compose:<version>")
    implementation("androidx.ink:ink-brush-compose:<version>")
    implementation("androidx.ink:ink-rendering:<version>")
    implementation("androidx.ink:ink-strokes:<version>")
    implementation("androidx.ink:ink-storage:<version>")
}
```

Check the release page for the current version before pinning.

## Architecture in a Compose app

```text
pen/stylus MotionEvents
      ▼
InProgressStrokes (authoring)  ── low-latency "wet" ink
      │ stroke finished
      ▼
immutable finished Stroke  ──▶  state holder (document model)
      ▼
CanvasStrokeRenderer / ViewStrokeRenderer  ── "dry" ink drawn in your UI
```

- Keep the document (list of finished strokes, selection, undo stack) in a
  ViewModel or state holder as immutable data. Compose renders from that state;
  the in-progress stroke surface is not driven by Compose state per frame.
- Do not forward every `MotionEvent` into snapshot state. The authoring module
  exists so wet ink bypasses the composition path for latency.
- Hand off a finished stroke to the document model once, then draw it with a
  renderer. Wet ink and dry ink must use the same brush so there is no visible
  color or width change on hand-off.
- Reuse renderer objects; do not recreate them per frame or per recomposition.

## Brushes

- Start with `StockBrushes` (marker, pressure pen, highlighter, emoji
  highlighter). Pass the stock brush version explicitly so a library upgrade
  cannot silently change how saved documents look.
- Custom `BrushFamily` APIs are public from `1.1.0-alpha03`. Serialize a
  `BrushFamily` with the module's encode/decode functions; when loading
  documents from other devices, use the decode overload that specifies maximum
  version compatibility and handle documents that need a newer Ink.
- Highlighter brushes have a self-overlap setting; choose it deliberately.
- Brush color shift operates in Oklab as of `1.1.0-alpha09` (`CHROMA` and
  `LIGHTNESS` targets replaced `SATURATION` and `LUMINOSITY`).

## Erasing, selection, geometry

- Whole-stroke erase and lasso selection use `ink-geometry` queries against a
  stroke's `PartitionedMesh`.
- The partial-stroke ("mesh editing"/"pixel") eraser is experimental (`1.1.0`
  alphas). `Stroke.subtract` and `Stroke.split` are annotated `@WorkerThread`:
  run them off the main thread and post the resulting strokes back to state.
- `1.1.0-alpha11` adds `PartitionedMesh` serialization so partially erased
  strokes can be saved and documents load faster.

## Persistence

Serialize stroke inputs (`StrokeInputBatch`) and brushes rather than rasterized
bitmaps: the stored form is a small fraction of the size and re-renders at any
zoom. Store the Ink version alongside the document and test round-trips,
including a document saved by an older build.

## Platform notes

- Android is the primary target. Ink also runs on server-side JVM (Linux x86_64
  only). On JDK 24+ the JNI loader emits a native-access warning unless
  `--enable-native-access=ALL-UNNAMED` is set.
- Cross-platform rendering (for example `MetalRenderer` on iOS) is behind
  `ExperimentalInkCrossPlatformRenderingApi` in the alpha line. Do not describe
  Ink as a stable Compose Multiplatform drawing library.

## Testing

- Test with a real stylus and a finger; palm rejection and hover differ.
- Record and replay `MotionEvent` sequences, including very fast strokes,
  stylus lift/re-touch, and concurrent inputs.
- Test configuration change and detach/reattach while a stroke is in progress.
- Measure end-to-end ink latency and frame time on low-end devices.
- Provide non-pen alternatives (touch drawing, keyboard/shape insertion) and
  accessible descriptions for the canvas content.

## Sources

- Ink release notes and dependencies: https://developer.android.com/jetpack/androidx/releases/ink
- Jetpack libraries overview: https://developer.android.com/jetpack
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: 198kUpdated 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: 198kUpdated 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: 198kUpdated Claude CodeCodexVerifiedInstall