Deploy
Deploy a Sunboard spec to the sandbox, where it's live for testing.
/sunboard.deploy uploads the spec your agent authored to Sunboard as a new,
immutable version and activates it in the sandbox (the development
environment), where it's live for testing against your pk_test_ key. It never
touches production, that's a separate sunboard promote step.
When to use it
- You've authored or changed a spec and want to see it run end to end.
What happens
- Confirms intent — deploy creates a new immutable version.
- Validates the spec and checks the install with
sunboard doctor. - Runs
sunboard deployand reports whether the version was newly uploaded or reused (the spec hash already matched the latest version). - Activates it in the sandbox — if the experience is already bound to a segment in development, the new version is live there immediately; if it's brand new, bind it once with Segment.
Test in the sandbox, then promote
Your local app runs on the pk_test_ key, so a deploy is instantly testable
with real persistence, segmentation, and routing. When it looks right, ship it
with sunboard promote <experience>. Reset the sandbox's test users with
sunboard env clear --environment development to run the flow again.