iOS Live Activities that don't silently fail.

Reading Paths

• Already shipping Live Activities

  Drop the contract and push client into your existing Expo app or backend without forking your bridge.

  1. 01 Adopt Mobile Surfaces For teams already shipping iOS Live Activities. Add the contract and push client without forking your bridge.
  2. 02 Push Wire-layer reference, SDK, smoke script, token taxonomy, error reasons, channel push.
  3. 03 Mobile Surfaces and expo-live-activity Cooperative positioning: what each project owns, when to use both, and the decision matrix.

• Starting from zero

  Scaffold an iPhone app with every surface wired up locally, ready to iterate against the simulator.

  1. 01 Quickstart Zero to a Live Activity on your Lock Screen in 30 minutes.
  2. 02 iOS Environment Dev builds, App Groups, generated native folders, simulator/device loops.
  3. 03 Surfaces Every kind value, what ships today, when to emit each, and the native target it drives.

• Backend integrator

  Emit snapshots and send APNs pushes from Node. No mobile work.

  1. 01 Backend Domain event to snapshot to APNs walkthrough.
  2. 02 Push Wire-layer reference, SDK, smoke script, token taxonomy, error reasons, channel push.
  3. 03 Observability Which catalog-bound errors are worth alerting on, hook signatures, recommended log shape.

• Triaging a silent failure

  A live bug where the Lock Screen is empty or APNs returns 200 with no effect.

  1. 01 Troubleshooting Symptom-to-fix recipes for silent iOS failures.
  2. 02 Trap Catalog Maintenance Schema and workflow for editing the trap catalog that generates AGENTS.md and CLAUDE.md.
  3. 03 Push Wire-layer reference, SDK, smoke script, token taxonomy, error reasons, channel push.

Full Reference

Trap catalog