Detox
wix.github.io
- Free plan
- Windows
- macOS
- Linux
- iPhone and iPad
- Android
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.
Plans
Every plan and priceDetox
Free plan
Getting started
- Open the Detox documentation website
- Write JavaScript end-to-end tests for iOS and Android
- Choose real devices or simulators for test runs
- Use Detox APIs with a test runner or without one
- Add the included Jest integration if desired
- Connect test runs to CI workflows
- 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.