SharePlay Developer

Quick Start

1. Decide whether this experience is launch-only co-location or shared state

sync.

1. Add the Group Activities capability and required entitlement before

building SharePlay UI.

1. Define one GroupActivity per experience and keep the payload minimal and

Codable.

1. Load the right reference only after you know the workflow.
2. For spatial personas or immersive spaces, load

[spatial-coordination.md](references/spatial-coordination.md) before joining.

Load References When

Workflow

1. Define the activity and choose the activation surface.
2. Observe and configure the session before joining.
3. Add messaging or journal synchronization only if shared state is required.
4. Configure spatial coordination when the experience shares an immersive

space.

1. Summarize the session lifecycle, sync model, and launch surface clearly.

When To Switch Skills

• Switch to build-run-debug when the blocker is app launch, simulator state,

or runtime debugging rather than SharePlay behavior.

• Switch to signing-entitlements when the issue is capabilities,

entitlements, or privacy gating.

• Switch to telemetry when proof of event ordering or session state changes

matters more than API design.

Guardrails

• Keep GroupActivity data small and Codable.
• Join only after the UI and local state are ready.

Output Expectations

Provide:

• the activity type and activation surface
• the chosen session and sync model
• which references were used
• the coordination model if immersive space is involved
• the next skill to use if the blocker is execution, signing, or testing