reference / deployment

Deployment

Deploy the generated documentation site to the existing Cloudflare Pages project and canonical domain.

Availablellms.txtSource evidence
Cloudflare Pages Deployment The public site deploys from the generated static build to a dedicated Pages project and custom domain. Cloudflare Pages Deployment The public site deploys from the generated static build to a dedicated Pages project and custom domain. generatespackagespublisheschecks live Public docs release builddeployverify 1 Source Documentation/siteBuild scriptScreenshotsSVG diagrams 2 Build distsearch indexllms files 3 Cloudflare ambient-desktop-docsmain branchPages deploy 4 Public desktop.ambient.xyzHTTPSDeep link checks
The public site deploys from the generated static build to a dedicated Pages project and custom domain.

Current Destination

The durable public destination is Cloudflare Pages project ambient-desktop-docs with canonical URL https://desktop.ambient.xyz. The generated build replaces the current parking page when the site is ready for publication.

Deploy Flow

  • Run the local docs build and docs check.
  • Inspect every generated SVG diagram for text overflow, overlapping arrows, clipped labels, unintended black fills, and mobile/desktop body overflow before deploying.
  • Export the Cloudflare token from the macOS Keychain only into the shell session that runs Wrangler.
  • Deploy Documentation/site/dist to ambient-desktop-docs on branch main.
  • Verify the home page, llms.txt, llms-full.txt, at least one deep link, DNS, HTTPS, and Pages deployment status.

Credential Warning

Never print, paste, commit, or store Cloudflare token values in documentation, logs, or artifacts. The existing token can deploy Pages; DNS changes may require dashboard access or a separate DNS-scoped token.