Skip to main content

Detox Intro

Detox is a library for end-to-end testing of React Native apps. This wiki provides information on how to use Detox effectively.


Detox's documentation for installation.

It's included by default in Ignite.

What's unique about Detox


One of the key features that makes Detox unique is that it synchronizes with app state, so it can know when to move to the next step of a test, instead of including manual sleep statements. See the documentation for more info.

But this does create new kinds of errors to be aware of. For example, if you see a Detox test hanging, that's an indication that Detox might not be detecting that the app went into the idle state so that the test can continue. To debug, check out Detox's troubleshooting guide on sync issues.

Flaky Tests

The RNR team interviewed Rotem Meidan, former lead of Detox, about Detox stability, in React-Native Radio 189.

He wrote an article about that here: Detox: Writing Stable Test Suites