Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Roborazzi

github.com

  • Free plan
  • Windows
  • macOS
  • Linux
  • iPhone and iPad
  • Android
7.8 Club score Visit github.com

What Roborazzi is

Roborazzi is an open-source library for screenshot testing in JVM Android integration tests. It records screenshots, compares them with saved images, and can fail verification when the images differ. Its Robolectric integration lets tests run as JVM tests without a device or emulator. Capture options cover Jetpack Compose nodes, Espresso views, Android Views, and Compose lambdas; the project also supports screenshot tests for Compose previews and Compose Multiplatform common previews. Roborazzi provides Gradle tasks for recording, comparing, and verifying screenshots, and its documentation describes GitHub Actions workflows for storing and checking them in CI. An IntelliJ IDEA and Android Studio plugin displays test screenshots in the IDE. Compose Desktop and JVM preview screenshot support are documented, while Compose Multiplatform iOS support is experimental. Additional options include accessibility checks, a machine-readable UI tree sidecar, GIF captures, and experimental video recording. Roborazzi is available on Maven Central under the Apache License 2.0. The project says rendering can vary across operating systems and does not guarantee identical screenshots between environments.

Who it suits

Roborazzi suits Android teams that want screenshot checks in JVM tests and CI workflows. It may also suit teams using Compose previews or exploring the project's experimental desktop and iOS support.

Good to know, and what to watch

  • Robolectric tests can run without a device or emulator
  • Capture APIs cover Compose, Espresso, and Android Views
  • Gradle tasks record, compare, and verify screenshots
  • GitHub Actions workflows are documented
  • No direct support for running with Bazel
  • Compose Multiplatform iOS support is experimental
  • Screenshot rendering can vary across operating systems
  • Video recording is experimental and not supported in compare or verify mode

Roborazzi

Free

Free plan

Getting started

  1. Open the Roborazzi GitHub repository
  2. Add the library from Maven Central
  3. Configure its Gradle tasks for recording, comparing and verifying screenshots
  4. Run screenshot tests with Robolectric or supported Compose and View capture APIs
  5. Optionally connect the documented GitHub Actions workflow
  6. Install the IntelliJ IDEA or Android Studio plugin to view test screenshots

Limits to check

Roborazzi has no direct Bazel support. iOS capture requires an explicit file path and PNG output, and video recording is experimental and not handled by compare or verify mode.

The Club's review

Roborazzi is a free, open-source screenshot verification library centered on Android JVM tests and Gradle. It is a strong fit for teams already using Robolectric, Compose, or mixed Android UI stacks that want visual regressions to fail like ordinary tests. Its desktop and iOS extensions broaden its reach, but experimental status and cross-platform rendering variance make environment discipline essential.

Overview

Roborazzi records screenshots, compares them with saved baselines, and fails verification when pixels differ. That gives UI changes a repeatable pass/fail gate in local development and continuous integration instead of relying on manual image inspection. Robolectric integration lets Android checks run as JVM tests without a physical device or emulator, and Hilt can be used in those tests.

Gradle tasks cover recording, comparison, and verification. Maven Central distribution lowers setup friction for Gradle builds, while the Apache License 2.0 permits use under a well-known permissive license. Documented GitHub Actions workflows can store screenshots and run checks in CI. The important operational caveat is rendering consistency: graphics libraries can produce different images on different operating systems, and the project does not promise identical output across environments.

Key features

  • Broad capture APIs: Tests can capture Jetpack Compose nodes, Espresso views, traditional Android Views, and Compose lambdas. This is useful for applications that mix legacy Views and Compose; a single tool can cover those surfaces.
  • Compose preview coverage: Roborazzi can generate screenshot tests from Jetpack Compose previews and supports Compose Multiplatform common previews. Teams designing reusable preview-driven components can bring those previews into regression checks rather than maintaining a separate capture path.
  • Desktop and iOS extensions: Compose Desktop and JVM preview screenshot tests render through the host's Skia library. Experimental Compose Multiplatform iOS support includes recording, comparison, verification, and reports, but iOS captures require an explicit file path and produce PNG only, without WebP encoding.
  • Developer and pipeline tooling: An IntelliJ IDEA and Android Studio plugin displays test screenshots in the IDE. Optional UI-tree output writes a machine-readable JSON sidecar for Android/Robolectric, Compose Desktop, and Compose iOS, which can help diagnostics and downstream tooling.
  • Animation and accessibility options: UI animations can be captured as GIF or APNG, and accessibility checks are available through a dedicated Roborazzi library. Video recording is experimental, and compare or verify mode does not record or verify video, so it is not a replacement for motion-focused testing.
  • AI assertions: Experimental modules support Gemini and OpenAI image assertions, alongside manual assertions that can use local or other LLMs. API keys should be supplied through environment variables rather than embedded in source code; teams with strict data policies should assess this feature before enabling it.

Pricing

Roborazzi is free: the Roborazzi plan costs nothing, is available on Maven Central, and is Apache-2.0 licensed. There are no paid tiers, seat charges, screenshot quotas, renewal terms, or trial expiry to weigh. That makes it attractive for teams that can operate their own baselines and CI storage. The trade-off is that the project does not provide a commercial service tier in these terms, so organizations wanting vendor-managed dashboards or support contracts may prefer a hosted alternative.

Platforms

The project targets Android and also lists iOS, Linux, macOS, and Windows. Android is the most established workflow, using Robolectric and JVM execution. Compose Desktop and Compose Multiplatform iOS are documented as experimental, and host Skia rendering can vary by operating system. There is no direct support for running Roborazzi with Bazel, which is a decisive limitation for Bazel-first build systems.

Who it's for

Choose Roborazzi when your Android team wants screenshot assertions inside Gradle tests, already uses Robolectric, or needs one capture API spanning Compose and Views. It also suits open-source and cost-sensitive projects that can standardize baseline and CI environments. It is less suitable for Bazel-based repositories, teams requiring guaranteed pixel identity across operating systems, or organizations seeking a hosted visual-testing service with vendor administration.

Pros and cons

Pros

  • Runs Android screenshot checks on the JVM, avoiding device and emulator requirements.
  • Handles Compose, Espresso, Android Views, previews, and Compose lambdas in one testing approach.
  • Free, Apache-2.0 licensed, Maven Central distributed, and equipped with Gradle and GitHub Actions workflows.
  • Optional UI-tree sidecars, IDE viewing, accessibility checks, and animated image capture extend diagnosis beyond a single diff.

Cons

  • Rendering can differ between operating systems, weakening portability of pixel baselines.
  • Compose Desktop and iOS support are experimental; iOS is restricted to explicit paths and PNG output.
  • No direct Bazel support excludes a common build workflow.
  • AI assertions and video recording are experimental, so they should not be treated as mature core guarantees.

Alternatives

Visual Regression Testing Software is the broader directory for comparing services and libraries when Roborazzi's JVM focus is not enough.

Pick Happo instead if you want a hosted freemium service spanning Android, API, iOS, and web, with a free allowance of 5,000 snapshots per month and visual plus accessibility testing. Percy is the better fit for web-inclusive teams seeking hosted plans, including a free tier with 5,000 screenshots per month, unlimited users, and unlimited projects.

SnapDiff is another freemium visual-diff option for API and web workflows. Choose Argos when an open-source, MIT-licensed SDK and platform with a forever-free hobby plan better match your governance model.

Screenshotbot suits teams wanting hosted coverage across Android, iOS, desktop, web, and self-hosted environments with pay-as-you-go pricing. Loki is a free, MIT-licensed open-source alternative for teams comfortable with its Node 16+ requirement. For broader cross-browser device coverage, consider Sauce Labs Cross-Browser Testing. Screenster is aimed at API, web, and Windows testing with a free per-tester plan and capped concurrent runs.

Verdict

Roborazzi is a compelling choice for Android and Compose teams that want no-cost, test-native screenshot verification through Robolectric and Gradle. Its capture breadth and CI tooling are the main reasons to choose it. Look elsewhere if you need direct Bazel support, guaranteed cross-OS pixel stability, or a mature hosted service with commercial management.

The verdict

Roborazzi offers screenshot recording and comparison across Android testing workflows, with additional Compose preview and desktop options. Check the project's platform limitations and rendering variation when deciding how to use it across environments.

Questions people ask

What does Roborazzi cost?

The Roborazzi plan is listed as free.

Is Roborazzi open source?

Yes. The repository identifies it as licensed under Apache License 2.0.

Which platforms are supported?

The project documents Android, experimental Compose Desktop and experimental Compose Multiplatform iOS support.

Can it run tests without a device?

Yes. Its Robolectric integration runs Android screenshot tests as JVM tests without a device or emulator.

Does it support CI?

Yes. The documentation describes GitHub Actions workflows for storing, comparing and verifying screenshots.

Does it support Bazel?

No direct support for running with Bazel is stated in the project FAQ.

What the maker publishes

Accessibility
The project provides a Roborazzi Accessibility Checks library that integrates accessibility checks with Roborazzi. source
AI assertions
An experimental AI-powered image assertion feature has modules for Gemini and OpenAI, and the project also describes manual assertions that can use local or other LLMs. source
Android testing
Roborazzi integrates with Robolectric to run screenshot tests as JVM tests without requiring a device or emulator. source
Animated captures
Roborazzi can capture GIFs and record UI animations as GIF or APNG; video recording is marked experimental and compare/verify mode does not record or verify it. source
Bazel support
The FAQ states there is no direct support for running Roborazzi with Bazel. source
Capture APIs
Screenshots can be captured from Jetpack Compose nodes, Espresso views, Android Views, and Compose lambdas. source
CI
The documentation describes integrating Roborazzi with GitHub Actions to store, verify, and compare screenshots. source
CI integration
The project documents GitHub Actions workflows for storing screenshots and verifying them in CI. source
Compose and Views
Screenshot capture supports Jetpack Compose nodes, Espresso views, Android Views, and Compose lambdas. source
Compose previews
It can generate screenshot tests for Jetpack Compose previews and supports Compose Multiplatform common previews. source
Desktop support
Roborazzi supports Compose Desktop and JVM preview screenshot tests, with screenshots rendered using the host's Skia. source
IDE integration
Its IntelliJ IDEA and Android Studio plugin displays screenshots from Roborazzi screenshot tests in the IDE. source
Integrations
Roborazzi is available on Maven Central and provides Gradle tasks for recording, comparing, and verifying screenshots. source
iOS limitation
On iOS, capture calls require an explicit file path and image output is PNG only, without WebP encoding. source
iOS support
Experimental Compose Multiplatform iOS support includes screenshot recording, comparison, verification, and reports. source
Known platform variation
The project says graphics libraries can render differently across operating systems and does not guarantee identical screenshot rendering across environments. source
License
The repository identifies Roborazzi as licensed under Apache License 2.0. source
Limitations
The project states that Roborazzi has no direct support for running with Bazel. source
Platform coverage
The project documents Android, experimental Compose Desktop, and experimental Compose Multiplatform iOS support. source
Purpose
Roborazzi is an open-source library for making JVM Android integration tests visible through screenshot testing. source
Robolectric
Roborazzi integrates with Robolectric and supports using Hilt in tests. source
Screenshot testing
It records screenshots, compares them with saved images, and can fail verification when images differ. source
Security
The AI assertion documentation advises passing API keys through environment variables rather than hard-coding them in code. source
UI tree output
An optional UI tree dump writes a machine-readable JSON sidecar alongside screenshots and is documented for Android/Robolectric, Compose Desktop, and Compose iOS. source

Checked against the maker's pages on 8 Oct 2026.