← All docs

Deploy, promote & roll back

How builds run, environments and auto-deploy, and instant rollback.

How a deploy works

  • The platform clones your repo at the exact commit, builds it in isolation, and stores an immutable release.
  • Static/React releases are published to a CDN-style origin; Node releases start a candidate container that must pass health checks before traffic switches.

Environments

  • Each project has environments (e.g. production, staging) mapping a branch to a deploy target.
  • Enable auto-deploy to deploy on every push to the mapped branch; production can require manual approval.
  • Customize an environment’s subdomain label under Environments → Edit — the env name, workspace ID and apps domain are always appended.

Rollback

  • Open an environment and select a previous release to roll back to. Rollback re-activates an existing release instantly — it never rebuilds the commit.