Walkthrough 3: the second deployment

Part 3 of 4. Previous: generate and deliver. Next: rollback and recovery.

Change content or a model, then deploy

Publish new content or change a model in the CMS. Settings → Source & delivery shows Out of date. Press Deploy on the Standalone backend card.

Deploy calls your build webhook. Your repository’s own dee-wan-build.yml then:

1. pulls the site’s definitions with a short-lived BUILD_TOKEN.
2. runs the regeneration script committed in your repository.
3. adds the next migration without rewriting existing migrations.
4. typechecks the backend, then installs, checks, builds and bundles the website.
5. commits, and deploys that exact commit through deploy-from-repository.yml.

What the second deployment keeps

• Everything under the owned zone, byte for byte.
• Shared files, with missing required keys added.
• Your own tables and their rows.
• Every migration already applied. An applied migration is never rewritten.

What it replaces

• Every generated file.
• The rows of generated content tables, from the new published snapshot. A row the snapshot does not hold is deleted, whoever wrote it.
• ACCESS_CONFIG: the CMS-issued read tokens from access/read-tokens.json together with vars.ACCESS_CONFIG in your wrangler.jsonc, or a valid empty token list (tokens: []) when there are none.

When it refuses

If a check refuses the build, deployment stops before the new commit is deployed. The last deployed website keeps serving. Common refusals:

Refusal	Meaning
An edited generated file, named	Move the change into src/owned/, then deploy again.
site_check_unavailable	The site’s type checker could not load. Its dependency install is incomplete.
site_check_failed, site_build_failed	The website does not typecheck or build.
site_bundle_failed	Wrangler cannot bundle the website’s Worker.
A generation refusal such as relation_type_unsupported	A model shape cannot be generated. Settings lists these before you deploy.

Next: rollback and recovery.

---

Unreleased / pre-MVP; no stable version
Source revision: fe23db481c422b40e317b92fc98116b4c0c26a87 (modified checkout)
Build date (UTC): 2026-10-18T09:22:34.630Z
Upgrade target: unavailable: modified checkout. Release notes