Outside In Testing IOS Apps

Installation (prerequisite):

brew install cameroncooke/axe/axe

The iOS Simulator must be running with the app under test.

Observe

• Take a screenshot: axe screenshot --udid {UDID} --output /tmp/screen.png
• Read the accessibility tree: axe describe-ui --udid {UDID}
• To inspect a specific point: axe describe-ui --point 100,200 --udid {UDID}

Act — choose based on what you need to do:

• Tap by accessibility label: axe tap --label "Login" --udid {UDID}
• Tap by accessibility identifier: axe tap --id "loginButton" --udid {UDID}
• Tap by coordinates (fallback): axe tap -x 200 -y 400 --udid {UDID}
• Type text: axe type 'user@example.com' --udid {UDID}
• Type from stdin: echo "text" | axe type --stdin --udid {UDID}
• Type from file: axe type --file input.txt --udid {UDID}
• Scroll: axe gesture scroll-down --udid {UDID}
• Swipe: axe swipe --start-x 200 --start-y 500 --end-x 200 --end-y 200 --duration 0.3 --udid {UDID}
• Advanced touch (hold): axe touch -x 150 -y 250 --down --up --delay 1.0 --udid {UDID}
• Press key: axe key 40 --udid {UDID} (Enter)
• Key sequence: axe key-sequence --keycodes 11,8,15,15,18 --udid {UDID}
• Home button: axe button home --udid {UDID}
• Siri: axe button siri --udid {UDID}

Verify After each action, take a screenshot and check whether the expected change occurred. If something is wrong, note the issue and investigate.

Timing controls — add delays when animations or loading cause flakiness:

• --pre-delay 0.5 — wait before acting
• --post-delay 1.0 — wait after acting
• --duration 0.3 — control gesture speed

For specific screen sizes: axe gesture swipe-from-left-edge --screen-width 430 --screen-height 932 --udid {UDID}

# Stream logs from the booted simulator (Ctrl+C to stop)
xcrun simctl spawn booted log stream --level debug --predicate 'subsystem == "com.apple.UIKit" OR processImagePath CONTAINS "{APP_NAME}"' 2>&1 | head -200

# Get recent log entries
xcrun simctl spawn booted log show --last 5m --predicate 'processImagePath CONTAINS "{APP_NAME}"' --style compact

# Check for crash logs
ls ~/Library/Logs/DiagnosticReports/*{APP_NAME}* 2>/dev/null

Replace {APP_NAME} with the app's process name (visible in describe-ui output or from xcrun simctl listapps booted).

If this is a React Native app, invoke the debugging-react-native skill (https://github.com/mikekelly/debugging-react-native) for React Native-specific diagnosis including Metro bundler issues, JS errors, and red box screens.