Add iOS bootstrap + E2E scripts and reference-app scripts READMEs

[Alex Freas (akfreas)]

Summary

Adds a one-shot bootstrap script and an E2E test runner for the iOS reference app, plus READMEs documenting the helper scripts for both the iOS and Android reference apps.

What's included

• implementations/ios-sdk/scripts/bootstrap.sh — one-shot configure → build → launch. Runs preflight checks first (macOS, Xcode Command Line Tools, full Xcode + license, an available iOS Simulator runtime, Node/pnpm, and XcodeGen — auto-installed via Homebrew if missing). Each failing check prints exact remediation steps and stops before anything is built. On success it builds the JS bridge, generates the Xcode project, starts the mock server, boots a simulator, and installs + launches the app. When idle, a simulator is running with the reference app and the mock server is up.
• implementations/ios-sdk/scripts/run-e2e.sh — runs the XCUITest suite via xcodebuild, sharing the same knobs as bootstrap.sh (APP_SHELL, IOS_SIM_NAME, MOCK_SERVER_PORT, SKIP_BUILD) plus ONLY_TESTING for targeting a single test, and APP_SHELL=both to run both shells.
• implementations/ios-sdk/scripts/README.md — documents both iOS scripts, their preflight checks, and environment variables.
• implementations/android-sdk/scripts/README.md — documents the existing bootstrap.sh, run-e2e.sh (UI Automator 2), and prepare-env.sh, with their environment variables.
• Updates implementations/ios-sdk/README.md with a "Running locally" section.

Unlike Android, the iOS scripts need no port forwarding: the Simulator shares the host network, so the app reaches the mock server at localhost:8000 directly.

Validation

• bash -n syntax check passes on both new scripts.
• Preflight detection logic validated command-by-command against a real macOS + Xcode 26.5 machine (including the fallback when the default iPhone 16 simulator is absent).
• READMEs formatted with Prettier; git diff --check clean.
• Did not run the scripts end-to-end (they build/launch/test the app); the iOS bootstrap was confirmed working separately by the author.

🤖 Generated with Claude Code