Detox

Overview

Detox is the gray-box end-to-end testing framework for React Native apps by Wix. Tests are written in JavaScript, run by Jest on your machine, and drive the real app on an iOS simulator or Android emulator. Because Detox runs inside the app as well, it knows when animations, timers and network requests are in flight and waits for the app to become idle before every action and assertion, which removes most timing flakiness without sleep calls. The price is setup: Detox needs a test build of the app per platform and a few native changes on Android.

Instructions

Initial Assessment

1. Platform — iOS, Android, or both? iOS tests only run on macOS.
2. React Native version — bare React Native or Expo? Detox has no Expo-specific support, and the Expo guide that the Detox docs link to now covers Maestro; treat Detox on Expo as community-maintained.
3. CI — Which CI provider? (GitHub Actions, CircleCI, Bitrise)
4. Current state — New project or adding tests to existing app?

Setup