skip to content
all examples

e2e with Expo

React Native with Expo, tested on web, iOS, and Android.

An Expo greeting app with three locator tests and two agent tests per platform.

Run

Use Node 22.22.3+, 24.8+, or 26+. From this folder:

terminal
npm install

Choose one platform:

PlatformBuild and installRun tests
WebThe runner starts Exponpm run test:e2e:web
iOSnpm run ios:releasenpm run test:e2e:ios
Androidnpm run android:releasenpm run test:e2e:android

For native builds, follow Expo's setup guide. Start a simulator or emulator before building. Rebuild after app changes. After config changes, run npx expo prebuild to update existing native projects.

Before a native run, check the setup for that platform:

terminal
npx e2e doctor --target ios

e2e doctor checks Node, the config, agent-device, the platform's toolchain, and the devices. With one booted simulator, emulator, or device, it also checks that the app is installed. Use --target android for Android.

Agent tests

Set a Vercel AI Gateway key:

terminal
AI_GATEWAY_API_KEY="your-key" npm run test:e2e:web

Use test:e2e:ios or test:e2e:android for native tests. Without the key, the agent tests skip. Add -- --no-cache to use fresh model calls. Results are in .e2e/report.json.

See e2e.config.ts and tests/ for the setup. For your own app, follow the Quickstart.

Last checked on 2026-11-11 with Expo SDK 57, e2e 0.23.0, @e2e-dev/web 0.15.5, @e2e-dev/mobile 0.12.6, and Xcode 26.3 on an iOS 26.3 simulator. npx e2e doctor --target ios passed, and the three locator tests passed on iOS and web. The agent tests and Android were not run.

[ get started ]

your verificationlayerstarts withjust one command

npx e2e@latest init