Cloudflare Pages deployment

PreactPress outputs static files, so Cloudflare Pages can serve the generated dist/ directory without a Node server.

Prerequisites#

• A PreactPress site committed to GitHub or GitLab
• Node.js 20 or newer
• A package script like:

{
  "scripts": {
    "check": "preactpress check",
    "build": "preactpress build"
  }
}

Configure PreactPress#

Set the final production URL in .preactpress/config.ts:

import { defineConfig } from "@kamod-ch/preactpress/config";

export default defineConfig({
  site: {
    title: "My Docs",
    description: "Documentation built with PreactPress",
    url: "https://docs.example.com",
    base: "/",
  },
});

Use base: "/" for normal Cloudflare Pages deployments. Only change base if you intentionally serve the site from a subpath.

Deploy with the Cloudflare dashboard#

1. Open Cloudflare Dashboard → Workers & Pages → Create application → Pages.
2. Connect your GitHub or GitLab repository.
3. Choose your PreactPress project.
4. Use these build settings:

If your docs live in a monorepo subfolder, set Root directory to that folder, for example:

packages/docs

Environment variables#

Set the Node version in Cloudflare Pages:

Cloudflare Pages usually detects pnpm from pnpm-lock.yaml. If needed, set:

Optional: run checks before build#

For stricter deployments, use this build command:

pnpm run check && pnpm run build

This fails the deployment when routes, nav links, sidebar links, or internal Markdown links are invalid.

Deploy with Wrangler#

You can also deploy the built dist/ directory manually with Wrangler:

pnpm run check
pnpm run build
pnpm dlx wrangler pages deploy dist --project-name my-preactpress-site

For a monorepo, run those commands from the site package directory or pass the correct output path.

Custom domains#

After the first deployment, add your domain in Pages → Custom domains. Then update site.url to match the production domain:

export default defineConfig({
  site: {
    url: "https://docs.example.com",
  },
});

This keeps canonical URLs, Open Graph metadata, sitemap.xml, robots.txt, and feeds correct.

See also Deploy, GitHub Actions, and Netlify.

Cache notes#

Cloudflare can cache hashed files under assets/ aggressively because their filenames change when content changes. Avoid immutable caching for HTML, preactpress-search.json, and preactpress-content/*.json.