# Install dependencies
pnpm install

# Verify environment
pnpm verify

# Build TypeScript
pnpm build

# Run in development mode
pnpm dev

{
  "projectPath": "/path/to/your/expo-app",
  "artifactsRoot": "./artifacts",
  "defaultDeviceName": "iPhone 15",
  "detox": {
    "configuration": "ios.sim.debug"
  }
}

{
  "mcpServers": {
    "expo-ios-detox": {
      "command": "node",
      "args": ["/path/to/expo_ios_development_mcp/dist/index.js"],
      "env": {
        "MCP_CONFIG": "/path/to/mcp.config.json"
      }
    }
  }
}

{
  "servers": {
    "expo-ios-detox": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/expo_ios_development_mcp/dist/index.js"],
      "env": {
        "MCP_CONFIG": "/path/to/mcp.config.json"
      }
    }
  }
}

Boot the iPhone 15 Pro simulator and start my Expo app

Set up a fresh test session - boot the simulator, start Expo, and initialize Detox

List all available iOS simulators and tell me which ones are booted

Take a screenshot of the current screen and save it as "home-screen"

Take a screenshot after each step of the login flow

Start recording a video, then stop it after I tell you the flow is complete

Tap the "Login" button on the home screen

Navigate to the Settings screen by tapping the settings icon (testID: settings-tab)

Scroll down on the main feed until you see the "Load More" button

Fill in the login form:
- Email: test@example.com
- Password: password123
Then tap the Submit button

Type "Hello World" into the search input (testID: search-input) and wait for results to appear

Clear the text in the email field and type a new email address

Swipe left on the first item in the list to reveal delete button

Swipe down to refresh the feed and wait for new content to load

Long press on the profile picture to open the context menu

Verify that the welcome message shows "Hello, John!"

Wait for the loading spinner to disappear and then check if the data loaded correctly

Assert that the error message "Invalid credentials" is visible after failed login

Save a baseline screenshot of the login screen for visual regression testing

Compare the current settings page against the baseline and tell me if there are any visual differences

Run visual regression on all saved baselines and report any failures

Here's the Figma design for the login screen. [paste screenshot]
Compare the current simulator view against this design and tell me the differences.

I've pasted the design mockup for the settings page. [paste screenshot]
Check if my implementation matches and list what needs to be fixed.

[paste Figma screenshot]
This is the target design. Please compare it against the simulator and fix any visual differences in the code.

Compare this design against my current implementation:
[paste screenshot]
Focus on the header section only (use region comparison).

# Login Screen Acceptance Criteria

## Visual Elements
- [ ] App logo is visible at the top of the screen
- [ ] Email input field is visible with placeholder "Enter email"
- [ ] Password input field is visible with placeholder "Enter password"
- [ ] "Sign In" button is visible and has text "Sign In"

## Interactions
- [ ] Tapping email field focuses the input
- [ ] Tapping "Sign In" button with valid credentials navigates to home screen
- [ ] Tapping "Forgot Password" link opens password reset modal

## Test Flows

### Happy Path Login
1. Wait for element `login-screen` to be visible
2. Type "test@example.com" into `email-input`
3. Type "password123" into `password-input`
4. Tap `sign-in-button`
5. Wait for element `home-screen` to be visible

Parse the acceptance criteria file at /path/to/login-criteria.md

Parse this acceptance criteria and tell me how many testable items there are:
[paste markdown content]

Run the acceptance criteria tests from /path/to/login-criteria.md

Run acceptance tests for the login screen and generate a report

Execute only the "Visual Elements" section from the acceptance criteria

Run the "Happy Path Login" test flow from the acceptance criteria file

Execute the signup flow from acceptance-criteria.md and take screenshots at each step

Check if the criterion "App logo is visible" passes

Verify the single criterion with ID "visual-1" from the acceptance file

## Missing Requirements for Testability

| Element | Suggested testID | Type | Reason |
|---------|-----------------|------|--------|
| App logo | `app-logo` | testID | Required for "App logo is visible" |
| Sign In button | `sign-in-button` | testID | Required for "Tapping Sign In button" |

Show me the last 100 lines of Expo logs - I'm seeing a crash

The app crashed after tapping the submit button. Collect evidence: take a screenshot,
get the logs, and help me debug what went wrong

Start streaming simulator logs so we can monitor for errors during testing

Test the complete signup flow:
1. Tap "Create Account"
2. Fill in name, email, password
3. Accept terms and conditions
4. Tap "Sign Up"
5. Verify the welcome screen appears
Take screenshots at each step

Run through the checkout flow and compare each screen against baselines:
1. Add item to cart
2. Go to cart
3. Proceed to checkout
4. Enter shipping info
5. Confirm order

Reproduce bug #123:
The app crashes when tapping the profile button while on the settings page.
Collect all evidence including screenshots and logs.

Execute this test flow:
- Wait for element "welcome-screen"
- Tap "get-started-button"
- Wait for element "onboarding-step-1"
- Swipe left
- Wait for element "onboarding-step-2"
- Swipe left
- Tap "finish-button"

Check the status of Metro - is it running and what's the bundle URL?

Reload the app to pick up my latest code changes

Stop Expo, clear the cache, and restart it fresh

Stop the Detox session and shut down the simulator

Erase the simulator to start with a clean slate

1. "Boot iPhone 15 and start Expo for my app"
2. Make code changes...
3. "Reload the app"
4. "Take a screenshot of the updated UI"
5. "Tap the new button I added and verify it works"
6. Repeat...

1. "Set up a test session with iPhone 15 Pro"
2. "Start recording a video"
3. "Navigate to the screen where the bug occurs"
4. "Perform the actions that trigger the bug"
5. "Stop recording and collect logs"
6. "Take a final screenshot and summarize what happened"

1. "Boot simulator and start Expo"
2. "Initialize Detox session"
3. "List all saved baselines"
4. "Compare each major screen against its baseline"
5. "Generate a report of any visual differences"

1. "Set up fresh test session - erase simulator first for clean state"
2. "Run the complete user registration flow with test data"
3. "Verify the user lands on the dashboard"
4. "Save baseline screenshots for key screens"
5. "Stop session and generate test summary"

1. Copy a Figma design screenshot
2. "Boot simulator and start Expo"
3. Paste the design: "Implement this login screen design: [paste]"
4. Claude Code implements the UI components
5. "Compare my implementation against the design"
6. Review the diff overlay and feedback
7. "Fix the spacing issues shown in the comparison"
8. Repeat comparison until design match is satisfactory

1. Write acceptance criteria in markdown (login-criteria.md)
2. "Boot simulator and start Expo"
3. "Initialize Detox session"
4. "Parse the acceptance criteria file at login-criteria.md"
5. "Run all acceptance tests and generate a report"
6. Review the report - fix any failing tests
7. Add missing testIDs reported in the "Missing Requirements" section
8. "Re-run the acceptance tests"
9. Repeat until all criteria pass

1. "Set up test session with iPhone 15"
2. Make code changes to your app...
3. "Reload the app"
4. "Run the acceptance criteria for the feature I'm working on"
5. Review pass/fail/blocked status
6. Fix issues and add missing testIDs
7. Repeat steps 2-6 until acceptance criteria pass

# Run with hot reload
pnpm dev

# Build for production
pnpm build

# Run production build
pnpm start

# Enable debug logging
MCP_DEBUG=true pnpm dev

src/
  index.ts          # MCP stdio entrypoint
  config/           # Configuration loading and validation
  core/             # State machine, errors, logger, artifacts, lock, retry
  mcp/              # MCP server, schemas, prompt templates
  simulator/        # simctl wrapper (devices, screenshots, video, logs)
  expo/             # Expo/Metro control (start, stop, logs, flow runner)
  detox/            # Detox micro-test runner (actions, selectors, output parsing)
  visual/           # Visual regression (baseline management, pixelmatch diff)
  acceptance/       # Acceptance criteria testing (parser, mapper, checker, reporter)