serve-sim

Scripted Workflow

Run the discrete scripts from the repository root:

1. Build the simulator app:

   bun run mobile:build:ios:simulator
   

2. Boot if needed, install, and launch:

   bun run mobile:sim:run
   

3. Start the detached browser stream:

   bun run mobile:sim:serve
   

   Surface the returned JSON url; it is the only authoritative stream address.

4. Stop helpers when finished unless the user asks to keep them running:

   bun run mobile:sim:kill
   

Completion means the app launched, the returned stream URL was surfaced, and requested interactions were verified.

Manual Controls

• Tap normalized coordinates: bunx serve-sim tap 0.5 0.5
• Type focused text: bunx serve-sim type "hello"
• Hardware home: bunx serve-sim button home
• Rotate: bunx serve-sim rotate portrait
• List streams: bunx serve-sim --list -q
• Accessibility tree: curl http://localhost:3100/ax

Run direct CLI commands from packages/mobile. serve-sim is installed in that package and is absent from the root node_modules/.bin.

Coordinates are normalized 0..1, not pixels. Prefer tap for simple taps; do not emulate taps using separate gesture begin/end commands because that can register as long press.

If accessibility lookup cannot identify a target, report the missing target instead of guessing coordinates.

Preconditions

• macOS host.
• Xcode installed; use DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer if xcode-select points at CommandLineTools.
• Node 18+.
• At least one simulator can be booted with xcrun simctl.