Detox
wix.github.io
What it is
Detox is an open-source framework for end-to-end testing of React Native mobile apps. It runs tests on real devices or simulators and simulates user interactions, with JavaScript tests for iOS and Android. Its gray-box method accesses app internals, while monitoring asynchronous app activity to reduce flaky tests. An async-await API supports breakpoints in asynchronous tests. Teams can use Detox APIs with any test runner or independently; Jest integration is included. The project describes it as suitable for CI and documents CI workflows. Detox is free under the MIT License, supports self-hosted runners and visual testing, and is listed for Android, iOS, Linux, macOS and Windows. React Native v0.77.x through v0.84.x is fully compatible with the New Architecture; later versions may work but are not thoroughly tested. Expo integration is community-driven and not maintained by the Detox team. Non-React Native Android apps are not supported. iOS simulator setup requires applesimutils, which the setup guide says is for macOS only.
Spec sheet
- 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.Read 7 Oct 2026 · wix.github.io
- Integrations
- Detox includes Jest integration, and its documentation also describes combining Detox APIs with Pilot natural-language test commands.Read 7 Oct 2026 · wix.github.io
- Support
- The project directs users to Stack Overflow, GitHub issues, and Discord for questions and support.Read 7 Oct 2026 · wix.github.io
- Headquarters
- Tel Aviv, IsraelRead 28 Sep 2026 · wix.github.io
- Founded
- 2006Read 28 Sep 2026 · wix.github.io
- Android limitation
- Detox currently does not support non-React Native apps on Android because of blocking issues.Read 7 Oct 2026 · wix.github.io
- CI
- The project describes Detox as suitable for CI and documents running its tests in CI workflows.Read 7 Oct 2026 · wix.github.io
- Debugging
- Its async-await API allows breakpoints in asynchronous tests to work as expected.Read 7 Oct 2026 · wix.github.io
- Expo limitation
- Expo integration is community-driven, has no special Detox support, and is not maintained by the Detox team.Read 7 Oct 2026 · wix.github.io
- iOS setup
- Detox requires applesimutils to work with iOS simulators, and its setup guide says this tool is for macOS only.Read 7 Oct 2026 · wix.github.io
- Pilot status
- The Pilot documentation says the feature is in active development and its APIs may change in future releases.Read 7 Oct 2026 · wix.github.io
- 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.Read 7 Oct 2026 · github.com
- Security and license
- The repository identifies the project as licensed under the MIT License.Read 7 Oct 2026 · github.com
- Synchronization
- Detox monitors asynchronous operations in the app to reduce flaky tests.Read 7 Oct 2026 · wix.github.io
- Test language
- Detox lets teams write cross-platform end-to-end tests in JavaScript for iOS and Android.Read 7 Oct 2026 · wix.github.io
- Test runners
- Detox provides APIs that can be used with any test runner or without one, and includes Jest integration out of the box.Read 7 Oct 2026 · wix.github.io
- Testing approach
- Detox uses gray-box testing by accessing app internals to improve control and predictability.Read 7 Oct 2026 · wix.github.io
Plans and prices
Strong points and limits
Strong points
- Free and licensed under MIT.
- Runs tests on real devices or simulators.
- Jest integration is included.
- Monitors asynchronous operations to reduce flaky tests.
- Supports visual testing and self-hosted runners.
Limits
- Does not support non-React Native Android apps.
- Expo integration is not maintained by the Detox team.
- iOS simulator setup requires applesimutils for macOS.
- Newer React Native versions are not thoroughly tested.
Who it suits
Detox suits teams writing JavaScript end-to-end tests for React Native apps on iOS and Android, including teams that need CI workflows or self-hosted runners. It is less suitable for non-React Native Android apps or teams seeking maintained Expo integration.
Verdict
Detox specifies its testing approach, runner options, and compatibility boundaries. Its clearest fit is React Native teams testing iOS and Android, with notable limits for Expo and non-React Native Android apps.
Where Specifiction places it
- GUI Testing Software#8 of 348.4
- Automated Testing#10 of 348.5
- Functional Testing Software#12 of 388.4
- End-to-End Testing Software#10 of 298.4
- Mobile App Testing Software#13 of 328.4