Deploy

/sunboard.deploy uploads your local spec to Sunboard as a new, immutable candidate version. It never publishes live onboarding — you (or a teammate) promote the version in Sunboard.

When to use it

The preview looks right and you're ready to ship a candidate for review.

What happens

Confirms intent — deploy creates a new immutable version.
Validates the spec and checks the install with sunboard doctor.
Runs sunboard deploy and reports whether the version was newly uploaded or reused (the spec hash already matched the latest version).
Tells you what's next — promote in Sunboard, and make sure a segment is bound.

Inactive until two things happen

A deployed version stays inactive until someone promotes it in Sunboard and a segment is bound for the target environment. Brand-new projects have no segments yet — that's the usual reason a fresh deploy isn't visible. Promotion always lives in Sunboard, never the CLI.

Preview

Verify before you ship.

Segment

Bind the version to an audience so it can serve.

Analyze

Watch the rollout once traffic flows.

CLI: deploy & hosted state

The deploy command and routing.