compose-quality

Community

Make Compose UIs accessible and testable

Authorsantimattius
Version1.0.0
Installs0

System Documentation

What problem does it solve?

It helps you deliver Jetpack Compose UIs that are accessible to TalkBack/Switch Access users and reliable to verify with Compose UI tests and screenshot testing.

Core Features & Use Cases

  • Accessibility semantics that match the user experience: apply mergeDescendants, clearAndSetSemantics, hideFromAccessibility, traversalIndex/isTraversalGroup, liveRegion, customActions, and roles/state descriptions to control what assistive technologies (and tests) can “see.”
  • Deterministic UI testing on the right tree: choose stable selectors (contentDescription/testTag over text when possible) and correctly use merged vs unmerged semantics (useUnmergedTree) to avoid flaky assertions.
  • Screenshot testing guidance with safe defaults: pick and configure screenshot test approaches (with warnings for alpha tooling) so visual regression is maintainable.

Quick Start

Use compose-quality when you are adding accessibility semantics to a custom component or writing Compose UI tests for an interaction that must be discoverable (including gesture-only actions like swipe-to-dismiss) and when you need stable selectors and correct assertions against the merged semantics surface.

Dependency Matrix

Required Modules

None required

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: compose-quality
Download link: https://github.com/santimattius/performance-compose-skills/archive/main.zip#compose-quality

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.