Detox

Detox is an open-source framework for end-to-end testing of React Native mobile apps. Teams can write cross-platform tests in JavaScript for iOS and Android, running them on real devices or simulators while simulating user interactions. Its gray-box approach accesses app internals, and monitoring asynchronous app activity is intended to reduce flaky tests. An async-await API supports breakpoints in asynchronous tests. Detox APIs work with any test runner or without one, and Jest integration is included. The project describes Detox as suitable for CI and documents running tests in CI workflows. It is free under the MIT License and supports self-hosted runners and visual testing, but not mobile web testing. React Native v0.77.x through v0.84.x is listed as fully compatible with the New Architecture; newer versions may work but are not thoroughly tested. Expo integration is community-driven and not maintained by the Detox team. Android testing does not extend to non-React Native apps. iOS simulator setup requires applesimutils, which the setup guide says is for macOS only.

Detox offers JavaScript end-to-end testing for React Native apps, with runner flexibility and Jest integration. Check its platform boundaries, Expo support status, and React Native compatibility range before adopting it.

Detox suits teams building React Native apps for iOS and Android that want JavaScript end-to-end tests and CI workflows. It may also fit teams that use Jest or another test runner.

Overview

Detox is a free, open-source framework for end-to-end testing of React Native apps, using JavaScript to exercise user flows on devices or simulators. It is best suited to teams building React Native apps for iOS and Android who want tests that can fit into CI without locking into a runner. Its focused approach is useful, but it is not a broad mobile or web testing tool.

Key features

Detox uses gray-box testing, accessing app internals as it simulates user interactions. That additional control, alongside monitoring of asynchronous operations, is intended to make tests more predictable and reduce flakiness. It is a strong fit for app-level flows where timing and state matter, though that depth does not extend its Android support to non-React Native apps.

Teams write cross-platform tests in JavaScript for iOS and Android. Detox APIs work with any test runner or without one, while built-in Jest integration offers a ready path for teams already using Jest. Its async-await API lets breakpoints work as expected in asynchronous tests, helping developers inspect failures without giving up asynchronous flows.

The project documents running tests in CI, making Detox suitable for teams that want end-to-end checks in their build workflows. Documentation also covers combining Detox APIs with Pilot natural-language test commands. Pilot remains in active development, however, and its APIs may change between releases.

Pricing

Detox costs nothing. Its sole Detox plan is the open-source framework under the MIT License, with a self-hosted runner. That makes it a practical option for teams able to manage their own test environment; there are no paid-plan features or hosted service tier to weigh against the free option.

Platforms

Detox supports testing React Native apps on iOS and Android, but setup and scope differ by platform. iOS simulator use requires applesimutils, a tool whose setup guide supports macOS only. Android currently does not support non-React Native apps because of blocking issues. Detox also does not support mobile web testing, so teams validating web experiences need another tool.

For React Native compatibility, versions 0.77.x through 0.84.x are listed as fully compatible with the New Architecture. Newer versions may work, but are not thoroughly tested. Expo integration is community-driven, receives no special Detox support, and is not maintained by the Detox team, making it a less certain choice for Expo projects.

Who it's for

Detox fits React Native teams that want code-authored JavaScript end-to-end tests for both major mobile platforms, prefer runner flexibility, and can operate a self-hosted setup. It is less suitable for teams whose core requirement is testing native Android apps, mobile web, or an Expo workflow backed by dedicated support. Questions and support are directed to Stack Overflow, GitHub issues, and Discord.

Pros and cons

• Pro: Gray-box access and asynchronous-operation monitoring aim to improve control and reduce flaky timing, useful for complex mobile flows.
• Pro: Any-runner APIs, optional runner use, and built-in Jest integration let teams adapt tests to their existing workflow.
• Pro: The MIT-licensed framework is free and can run in self-hosted environments.
• Con: Android testing is limited to React Native apps, ruling it out for non-React Native Android coverage.
• Con: iOS simulator setup depends on applesimutils, which is for macOS, narrowing simulator setup options.
• Con: Expo support is community-driven rather than maintained by the Detox team, and Pilot APIs may change while that feature is in development.

Alternatives

Maestro is worth considering for teams seeking a freemium option with local open-source tooling, including CLI, Studio, Viewer, and local agents, across a broader set of platforms including web.

testRigor may suit teams looking for a freemium testing option that spans mobile, web, API, and other listed platforms; its Public Open Source plan makes tests and results public.

Katalon Studio is an alternative for teams who want low-code and full-code authoring with web, mobile, and desktop coverage, alongside an AI Assistant and MCP Server.

TestCafe is a free, MIT-licensed test runner to consider when a team needs a web-capable alternative across a wide range of platforms.

TestMu AI Web Automation may fit teams needing hosted web and mobile automation sessions, though its free plan is capped at 100 lifetime minutes and two parallel sessions.

Tricentis Testim is an option for teams whose needs span web and mobile testing and can fit its customized paid plans; its free plan allows up to 1,000 runs per month.

WebdriverIO is another free open-source automation framework, with Node.js required.

Nightwatch is another free, open-source option with no paywalls.

Browse functional testing software, end-to-end testing software, mobile app testing software, and GUI testing software for more options.

Verdict

Choose Detox if you build React Native apps and want free, runner-flexible JavaScript end-to-end tests with gray-box control and CI support. Look elsewhere if you need non-React Native Android coverage, mobile web testing, or a more dependable Expo integration.