This documentation is available as Markdown. For the complete index, see llms.txt. Skip to content
unotest

Quick start — iOS

For the complete documentation index, see llms.txt
View Markdown Open in ChatGPT Open in Claude

unotest mobile drives your iOS Simulator and writes real test scenarios for your app — React Native / Expo or native Swift. Works with any backend stack; no JS expertise required from you.

1. Point it at your built .app

Terminal window
npx @unotest/mobile install /path/to/Your.app --update-env

This installs the app on the Simulator and auto-detects the bundle ID, URL scheme and required permissions from Info.plist. On first run it offers to bootstrap unotest/ and .mcp.json.

Common .app locations:

  • React Native / Expo: ./ios/build/Build/Products/Debug-iphonesimulator/<App>.app after npx expo run:ios.
  • Native Swift: Xcode → Product → Show Build Folder → Products/Debug-iphonesimulator/.

2. Ask your agent for a test

Open Claude Code (or Cursor / Codex) in the same directory and ask for a test. The agent drives the Simulator over MCP, reading the live accessibility tree — not screenshots — and records a clean .js scenario.

3. Run it

Terminal window
npx @unotest/mobile e2e <name>

Scenarios are plain .js in unotest/e2e/ — into git, code review and CI.

Next