Skip to main content

Publish Docusaurus to auraison-docs.aegeanai.com via Cloudflare Pages

Date: 2026-03-07 Status: Approved

Problem​

Design docs in docs/ are only viewable locally via npm start in docs-site/. They should be published to auraison-docs.aegeanai.com so the team can browse them without running anything locally.

Architecture​

push to main (docs/** or docs-site/**)
  → GitHub Actions
  → npm run build
  → wrangler pages deploy docs-site/build
  → Cloudflare Pages (auraison-docs.aegeanai.com)

No S3, no reverse proxy, no Cloudflare tunnel. Cloudflare Pages handles hosting, CDN, and TLS.

Components​

1. Cloudflare Pages project​

  • Project name: auraison-docs
  • Created via wrangler pages project create auraison-docs --production-branch main
  • Custom domain: auraison-docs.aegeanai.com
    • CNAME added automatically by Cloudflare (DNS zone is in the same account)

2. GitHub Actions workflow​

File: .github/workflows/deploy-docs.yml

  • Trigger: push to main with path filter on docs/** and docs-site/**
  • Steps:
    1. Checkout repo
    2. Setup Node.js
    3. cd docs-site && npm ci && npm run build
    4. npx wrangler pages deploy build --project-name=auraison-docs
  • Secrets: CLOUDFLARE_API_TOKEN (scoped to Pages:Edit + Account Settings:Read)
  • Variables: CLOUDFLARE_ACCOUNT_ID

3. Docusaurus config update​

Change url in docs-site/docusaurus.config.ts from http://localhost to https://auraison-docs.aegeanai.com.

Domain reservation​

  • auraison-docs.aegeanai.com — this docs site
  • auraison.aegeanai.com — reserved for the main app (control plane UI)

What we skip​

  • No S3/MinIO involvement
  • No Cloudflare tunnel configuration
  • No nginx/Caddy proxy
  • No manual deploy scripts