MkDocs

Deploy to Workers

Build and deploy the documentation site with Wrangler.

The template builds a static FumaPress site and publishes it with Cloudflare Workers Static Assets.

Set site identity

Update src/site.config.ts, public/robots.txt, and the Worker name in wrangler.jsonc.

Authenticate Wrangler

Use wrangler login locally or provide CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID in CI.

Run the full validation

pnpm check

This checks generated sources, TypeScript, the production build, and a Wrangler dry run.

Deploy

pnpm deploy

Custom domain

Add a Worker Custom Domain when the zone is managed by Cloudflare:

{
  "routes": [
    {
      "pattern": "docs.example.com",
      "custom_domain": true
    }
  ]
}

Check existing DNS

Check for a conflicting CNAME before deploying the route.

Last updated on

On this page