Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time
March 26, 2017 20:58
November 10, 2022 11:01
May 24, 2023 18:22
May 24, 2023 13:11
December 28, 2022 07:55
May 24, 2023 13:12
September 16, 2022 20:26
November 16, 2021 20:23
July 20, 2022 23:09
May 13, 2019 18:26




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! Discord Twitter Follow

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('');
    await element('password')).typeText('123456');
    await element(by.text('Login')).tap();

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

Get started with 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 end-to-end tests in JavaScript. Currently supports iOS and Android.
  • Debuggable: Modern async-await API allows breakpoints in asynchronous tests to work as expected.
  • 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 CI, Circle CI or Jenkins without grief.
  • Runs on Devices: Gain confidence to ship by testing your app on a device/simulator just like a real user (not yet supported on iOS).
  • Test Runner Agnostic: Detox provides a set of APIs to use with any test runner without it. It comes with Jest integration out of the box.

Supported Versions



  • macOS: v10.15 (Catalina) or higher
    • Xcode: v11.0 or higher
    • iOS Simulator Runtime: iOS v13.0 or higher
  • Ubuntu linux: v20.04 or higher
  • Windows 10: Version 1803 or higher

React Native

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

Detox works, at least officially, with the following React Native versions:

iOS Android
0.68.x - 0.70.7 0.68.x - 0.70.7 -
Visibility edge-case: see this RN issue

Newer versions, as well as React Native's "New Architecture", are most likely supported, but have not been tested out yet. Please submit an issue if you find specific problems with more recent React Native versions.

For support for React Native 0.71.x, please track this issue.

Get Started with Detox

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

Documents Site

Explore further about using Detox from our new website.

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

Detox has been open-source from the first commit. If you’re interested in helping out with our roadmap, please see issues tagged with the 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.


Non-English Resources (Community)