About roborazzi
Roborazzi is an Android screenshot-testing skill for JVM-based tests using Robolectric Native Graphics. It covers views, Jetpack Compose, Compose Previews, and Compose Multiplatform, along with recording, comparison, and verification workflows.
Key features
- 01Run screenshot tests as JVM unit tests
- 02Test Android views and Jetpack Compose
- 03Record, compare, and verify screenshots
- 04Capture GIFs and videos
- 05Generate UI tree dumps
Use cases
- 01Test UI screenshots without a device or emulator
- 02Verify screenshot changes in a build workflow
- 03Generate screenshot tests from Compose Previews
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/roborazziin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
references/ai_powered_image_assertion.mdbuild_setup.mdcompose_multiplatform.mdfaq.mdgif_and_video.mdgithub_actions.mdgradle_properties_options.mdhow_to_use.mdidea_plugin.mdpreview_support.mdtop.mdtry_it_out.mdui_tree_dump.mdDetails
From the project READMERoborazzi
Roborazzi is a screenshot testing library for Android that runs on the JVM using Robolectric Native Graphics, so screenshot tests run as JVM unit tests without a device or emulator. It works with plain Android views, Jetpack Compose (including Compose Previews), and Compose Multiplatform.
The typical workflow: record baseline images with ./gradlew recordRoborazziDebug, then compare or
verify against them with compareRoborazziDebug / verifyRoborazziDebug (task names vary by
variant; see the build setup reference).
Reference index
Read the reference that matches the task at hand:
| File | Read when |
|---|---|
| references/top.md | You need an overview of what Roborazzi is and why to use it over device tests or Paparazzi. |
| references/try_it_out.md | You want a minimal quick start or a sample project to try Roborazzi. |
| references/build_setup.md | Setting up the Gradle plugin and dependencies, or running/understanding the record/compare/verify Gradle tasks and their outputs. |
| references/how_to_use.md | Writing tests: captureRoboImage for views/Compose/Espresso, RoborazziRule and its options, output paths and file naming, RoborazziOptions (thresholds, image comparators, dump mode). |
| references/gif_and_video.md | Capturing GIFs and videos of test interactions: captureRoboGif, recordRoboVideo / recordScreenRoboVideo, RoboVideoOptions, GIF vs APNG output. |
| references/ui_tree_dump.md | UI tree dump: the machine-readable .uitree.json semantics sidecar and annotated Set-of-Mark image for tools & AI agents (roborazzi.dumpUiTree, uiTreeDumpOptions), including the verify-a-UI-fix-by-bounds workflow. |
| references/github_actions.md | Setting up GitHub Actions CI for Roborazzi: workflows that store baseline screenshots, verify them, and compare snapshot results on pull requests. |
| references/preview_support.md | Generating screenshot tests from @Preview composables with ComposablePreviewScanner, including setup and customization of preview tests. |
| references/compose_multiplatform.md | Screenshot testing Compose Multiplatform targets (iOS, desktop/JVM), including feature support per platform. |
| references/ai_powered_image_assertion.md | Asserting screenshot content with AI models (OpenAI, Gemini) via roborazzi-ai modules. |
| references/gradle_properties_options.md | Configuring roborazzi.* Gradle properties: task behavior, output directory, file-name strategy, comparison report settings. |
| references/idea_plugin.md | Using the Roborazzi IntelliJ IDEA / Android Studio plugin to view screenshots in the IDE. |
| references/faq.md | Troubleshooting: common errors, CI setup questions, Robolectric configuration issues, and other frequently asked questions. |
The files under references/ mirror the official Roborazzi documentation at the time this skill
was published. The latest version is always available at
the documentation site.