by wix

wix / Detox

Gray box end-to-end testing and automation framework for mobile apps

7.1K Stars 1.3K Forks Last release: 5 days ago (17.10.3) MIT License 3.0K Commits 303 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:


Gray box end-to-end testing and automation library for mobile apps.


NPM Version NPM Downloads Build Status Coverage Status Detox is released under the MIT license PR's welcome!

What does a Detox test look like?

This is a test for a login screen, it runs on a device/simulator like an actual user:

describe('Login flow', () => {

it('should login successfully', async () => { await device.reloadReactNative();

await element('email')).typeText('[email protected]');
await element('password')).typeText('123456');
await element(by.text('Login')).tap();

await expect(element(by.text('Welcome'))).toBeVisible();
await expect(element('email'))).toNotExist();



Start using Detox now!


High velocity native mobile development requires us to adopt continuous integration workflows, which means our reliance on manual QA has to drop significantly. Detox tests your mobile app while it's running in a real device/simulator, interacting with it just like a real user.

The most difficult part of automated testing on mobile is the tip of the testing pyramid - E2E. The core problem with E2E tests is flakiness - tests are usually not deterministic. We believe the only way to tackle flakiness head on is by moving from black box testing to gray box testing. That's where Detox comes into play.

  • Cross Platform: Write cross-platform tests in JavaScript. Currently supports iOS and Android.
  • Runs on Devices (not yet supported on iOS): Gain confidence to ship by testing your app on a device/simulator just like a real user.
  • Automatically Synchronized: Stops flakiness at the core by monitoring asynchronous operations in your app.
  • Made For CI: Execute your E2E tests on CI platforms like Travis without grief.
  • Test Runner Independent: Use Jest, Mocha, AVA, or any other JavaScript test runner you like (spoiler: we have our favourite).
  • Debuggable: Modern async-await API allows breakpoints in asynchronous tests to work as expected.

Supported versions


  • OS: macOS 10.14 (Mojave) or higher
  • Xcode: 10.2 or higher
    • iOS Simulator Runtime: iOS 12.2 or higher

React Native

Detox is built from the ground up to support React Native projects as well as pure native ones.

The following React Native versions have been tested:

| iOS | Android | | ------ | ------------------------------------------------------------ | | <=0.63 | <=0.56 - Full support | | | >=0.57 <=0.63 - Visibility edge-case: see this RN issue* |

Future versions are most likely supported, but have not been tested yet. Please open issues if you find specific issues with newer React Native versions.

Get Started With Detox!

Read the Getting Started Guide to get Detox running on your app in less than 10 minutes.

Documents Directory

Explore further about using Detox from the documents directory.

Rethinking Core Principles

We believe that the only way to address the core difficulties with mobile end-to-end testing is by rethinking some of the principles of the entire approach. See what Detox does differently.

Contributing to Detox

Open source from the first commit. If you're interested in helping out with our roadmap, please see issues tagged marked with the  looking for contributors label. If you have encountered a bug or would like to suggest a new feature, please open an issue.

Dive into Detox core by reading the Detox Contribution Guide.


  • Detox by itself and all original source code in this repo is MIT
  • Detox relies on some important dependencies, their respective licenses are:

Non-English Resources (External)

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.