Project setup

How setup works

Setup is the dashboard wizard's pipeline, drivable from any lane: your description becomes a vision, the vision becomes a checkpoint plan with a cost estimate, and the agent builds checkpoint by checkpoint, publishing the finished build to your development environment. The CLI and SDK wrap the underlying draft lifecycle (create a draft, generate the vision, prepare the plan, start) into one call; the API lane shows the composed mutations for integrators who need each stage.

Start a setup

Describe the app and start the build. The CLI checks your credit balance against the estimate and prints the plan for confirmation (--yes skips it, for CI and agents); inspiration images and exact design comps steer the result.

spaceboy setup start "A storefront for handmade ceramics" --yes
spaceboy setup start "..." --file inspiration.png        # repeatable
spaceboy setup start "..." --design home.png:home --strict-design
spaceboy setup start "..." --model <id> --template <key>

CLI and SDK setups auto-publish the finished build to your development environment and finish with the live URL. In the dashboard wizard, auto-publish is a switch on the Plan step.

Follow progress

Read the draft's status, checkpoints, and event stream. The CLI's --wait follows a running build to the finish.

spaceboy setup status                 # latest setup (--draft <id> for another)
spaceboy setup status --wait          # follow to the finish
spaceboy setup events --draft <id>    # the event timeline

Review checkpoints

Builds pause at checkpoints for review. Accept what's under review, or accept-and-start the next checkpoint in one step.

spaceboy setup checkpoints            # the roadmap and each status
spaceboy setup accept                 # mark reviewed checkpoints accepted
spaceboy setup next [--wait]          # accept and start the next one

Script any wizard step

Every wizard control — capabilities, marketing pages, styling, auth emails, publishing — writes the same step payloads the dashboard screens save. The server rejects unknown step keys.

spaceboy setup step set capabilities --data '{"capabilities":["AUTH"]}'
spaceboy setup step show [stepKey]    # read a step (or all steps) back

Retry or cancel

Re-run a failed setup on the kept project, or cancel a running one.

spaceboy setup retry --draft <id>
spaceboy setup cancel --draft <id>

Pick the model

The models that can conduct a setup run, with the server's recommendation.

spaceboy setup models

Migrate an existing repo

Transplant an existing repository into a Spaceboy project: analyze, provision, transplant, verify — then a pull request parks for your review.

spaceboy setup migrate acme/store --ref main
spaceboy setup migrate acme/store --no-wait   # start it and return