Deployments

Deploying your app

Click Deploy in the workspace and choose a development or production environment. Static (client-only) apps deploy free on every plan — on the free plan they carry a small Spaceboy badge and you can keep one live at a time. Apps that need provisioned infrastructure (a database or auth) prompt an upgrade on the free plan; Starter, Pro, and Team organizations can deploy everything.

The deploy flow

Deploys run as a clear, staged flow you can watch live: database migrations, then the backend, then the web app. A successful deploy returns your live URL along with a full report of exactly what shipped at each stage.

Deploy history

Every deploy is recorded in the Deploys tab, so you can revisit any release later — what went out, where, and when.

Production releases

Production deploys get an extra layer of protection: every release — whether you requested it or a task auto-promoted its finished work — must pass the repository's own release checks before it merges. See Release checks for how the pipeline works.

Deploy from anywhere

The Deploy button is one of four ways to ship. Ask your agent in chat, run /spaceboy deploy production from a linked Slack channel, or deploy from your terminal:

spaceboy deploy --project <id> --target production   # waits, prints the live URL
spaceboy deploy --project <id> --target development --no-wait

Every surface follows the same rails — plan entitlements, the staged flow, and release checks for production — so a deploy is a deploy no matter where you start it.

Your live environment

A successful deploy ends with a live URL on a Spaceboy domain, ready to share. From there, attach a domain you own on the project's Domains page, and watch the app run from the dashboard: Analytics for traffic, Data for the database, Users for sign-ups, and Jobs for background work.