Roborazzi
github.com
- Free plan
- Windows
- macOS
- Linux
- iPhone and iPad
- Android
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
Plans
Every plan and priceRoborazzi
Free plan
Getting started
- Open the Roborazzi GitHub repository
- Add the library from Maven Central
- Configure its Gradle tasks for recording, comparing and verifying screenshots
- Run screenshot tests with Robolectric or supported Compose and View capture APIs
- Optionally connect the documented GitHub Actions workflow
- 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.