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

Detox

wix.github.io

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

What Detox is

Detox is an open-source framework for end-to-end testing of React Native mobile apps. Teams 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 it tracks asynchronous app activity to help tests run more predictably. The async-await API supports working breakpoints in asynchronous tests. Detox APIs can be used with any test runner or on their own, and Jest integration is included. The project documents running tests in CI workflows. Detox is free under the MIT License and supports visual testing and self-hosted runners. Compatibility has boundaries: React Native v0.77.x through v0.84.x is listed as fully compatible with the New Architecture, while newer versions may work but are not thoroughly tested. Expo integration is community-driven and not maintained by the Detox team. It does not support non-React Native apps on Android. iOS simulator setup requires applesimutils, which the setup guide says is for macOS only.

Who it suits

Detox suits teams building React Native apps for iOS and Android that want JavaScript end-to-end tests and CI workflows. Teams using Expo or testing non-React Native Android apps should note its support limits.

Good to know, and what to watch

  • Free and licensed under MIT.
  • Tests run on real devices or simulators.
  • Includes Jest integration and supports other runners.
  • Monitors asynchronous app activity.
  • Supports visual testing and self-hosted runners.
  • Does not support non-React Native Android apps.
  • Expo integration is community-driven and not team-maintained.
  • iOS simulator setup requires a macOS-only tool.
  • Newer React Native versions are not thoroughly tested.

Detox

Free

Free plan

Getting started

  1. Open the Detox documentation website
  2. Write JavaScript end-to-end tests for iOS and Android
  3. Choose real devices or simulators for test runs
  4. Use Detox APIs with a test runner or without one
  5. Add the included Jest integration if desired
  6. Connect test runs to CI workflows
  7. Use applesimutils on macOS when testing iOS simulators

Limits to check

React Native 0.77.x through 0.84.x is fully compatible with the New Architecture; newer versions are not thoroughly tested. Expo integration is community-driven, non-React Native Android apps are unsupported, and iOS simulator setup requires applesimutils on macOS.

The verdict

Detox brings app-aware end-to-end testing and flexible runner options to React Native teams. Check the Android, Expo, and iOS setup boundaries against your project before adopting it.

Questions people ask

Is Detox free?

Yes. Detox is free and open source under the MIT License.

Which platforms does Detox support?

The listed platforms are Android, iOS, Linux, macOS, and Windows. Tests target React Native apps on iOS and Android.

Can Detox run on real devices?

Yes. Tests can run on real devices or simulators while simulating user interactions.

Does Detox work with Jest?

Yes. Jest integration is included, and Detox APIs can also work with other runners or without a runner.

Does Detox support Expo?

Expo integration is community-driven, has no special Detox support, and is not maintained by the Detox team.

Is Detox suitable for CI?

Yes. The project describes it as suitable for CI and documents running tests in CI workflows.

What the maker publishes

Android limitation
Detox currently does not support non-React Native apps on Android because of blocking issues. source
CI
The project describes Detox as suitable for CI and documents running its tests in CI workflows. source
Debugging
Its async-await API allows breakpoints in asynchronous tests to work as expected. source
Expo limitation
Expo integration is community-driven, has no special Detox support, and is not maintained by the Detox team. source
Founded
2006 source
Headquarters
Tel Aviv, Israel source
Integrations
Detox includes Jest integration, and its documentation also describes combining Detox APIs with Pilot natural-language test commands. source
iOS setup
Detox requires applesimutils to work with iOS simulators, and its setup guide says this tool is for macOS only. source
Pilot status
The Pilot documentation says the feature is in active development and its APIs may change in future releases. source
React Native compatibility
The project lists React Native v0.77.x through v0.84.x as fully compatible with the New Architecture; newer versions may work but are not thoroughly tested. source
Security and license
The repository identifies the project as licensed under the MIT License. source
Support
The project directs users to Stack Overflow, GitHub issues, and Discord for questions and support. source
Synchronization
Detox monitors asynchronous operations in the app to reduce flaky tests. source
Testing approach
Detox uses gray-box testing by accessing app internals to improve control and predictability. source
Test language
Detox lets teams write cross-platform end-to-end tests in JavaScript for iOS and Android. source
Test runners
Detox provides APIs that can be used with any test runner or without one, and includes Jest integration out of the box. source
What it does
Detox is an open-source end-to-end testing framework for React Native mobile apps that tests on real devices or simulators and simulates user interactions. source

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