Skip to main content
Purpose: ship a phone client that can approve agent requests for a FAU node. Audience: mobile engineers forking apps/phone/ or writing a new client.

What this client is

A paired device, not an inbox. It holds an Ed25519 secret, signs /papi/*, and optionally wakes via Expo Push. Protocol pages: Mobile clients, Apps overview.

Path A — Reference app (apps/phone)

Prerequisites

  • Node.js 20+
  • Expo / EAS account
  • Physical device for push (simulator is insufficient to sign off)
  • Apple Developer membership for iOS

1. Install and test

2. Configure push credentials

3. Build for a device

Install via the Expo link. Register the device for ad hoc if integrity verification fails.

4. Pair and verify

  1. Mac shows pair QR → scan in app → allow notifications.
  2. Settings: alerts registered.
  3. Dashboard → Send test alert → banner while app backgrounded.
  4. Optional: create a real approval and decide.
Device signatures must match Device signing vectors.

Path B — Your own app

Implement:
  1. Pairing
  2. Device signing
  3. Phone API
  4. Push — your EAS/APNs project; node only stores tokens
Ship bar: App checklist.

Invariants

  • Never put mail content in push payloads
  • Never put the device secret on your servers
  • Never use the Mac dashboard X-FAU-Local token from mobile
  • Polling remains mandatory even when push works

Next