​

iOS App (Node)

​

What it does

• Connects to a Gateway over WebSocket (LAN or tailnet).
• Exposes node capabilities: Canvas, Screen snapshot, Camera capture, Location, Talk mode, and Voice wake.
• Receives node.invoke commands and reports node status events.

​

Requirements

• Gateway running on another device (macOS, Linux, or Windows via WSL2).
• Network path:
  • Same LAN via Bonjour, or
  • Tailnet via unicast DNS-SD (example domain: fased.internal.), or
  • Manual host/port (fallback).

​

Quick start (pair + connect)

1. Start the Gateway:

fased gateway --port 18789

2. In the iOS app, open Settings and pick a discovered gateway (or enable Manual Host and enter host/port).
3. Approve the pairing request on the gateway host:

fased devices list
fased devices approve <requestId>

4. Verify connection:

fased nodes status
fased gateway call node.list --params "{}"

​

Discovery paths

​

Bonjour (LAN)

​

Tailnet (cross-network)

​

Manual host/port

​

Canvas + A2UI

fased nodes invoke \
  --node "iOS Node" \
  --command canvas.navigate \
  --params '{"url":"http://<gateway-host>:18789/__fased__/canvas/"}'

• The Gateway canvas host serves /__fased__/canvas/ and /__fased__/a2ui/.
• It is served from the Gateway HTTP server. Same port as gateway.port; default 18789.
• The iOS node auto-navigates to A2UI on connect when a canvas host URL is advertised.
• Return to the built-in scaffold with canvas.navigate and {"url":""}.

​

Canvas eval / snapshot

fased nodes invoke \
  --node "iOS Node" \
  --command canvas.eval \
  --params '{"javaScript":"document.body.innerHTML = \"<h1>Fased Canvas</h1>\"; \"ok\";"}'

fased nodes invoke --node "iOS Node" --command canvas.snapshot --params '{"maxWidth":900,"format":"jpeg"}'

​

Voice wake + talk mode

• Voice wake and talk mode are available in Settings.
• iOS may suspend background audio; treat voice features as best-effort when the app is not active.

​

Common errors

• NODE_BACKGROUND_UNAVAILABLE: bring the iOS app to the foreground. Canvas, camera, and screen commands require it.
• A2UI_HOST_NOT_CONFIGURED: the Gateway did not advertise a canvas host URL. Check canvasHost in Gateway configuration.
• Pairing prompt never appears: run fased devices list and approve the request manually.
• Reconnect fails after reinstall: the Keychain pairing token was cleared; re-pair the node.

​

Related docs

• Pairing
• Discovery
• Bonjour