Deploy to Cloudflare Pages
1 minute read
Deploy to Cloudflare Pages
Cloudflare Pages runs a build command on Node, so it can build a Slipway site with the engine. There is no Gemfile and no Jekyll build step.
Prerequisites
Keep the engine and the theme in the site's package.json:
npm install --save-dev @velella/mizzen @velella/lateen
Set url in mizzen.yml to the site's address, such as https://docs.example.com, so canonical links and the sitemap use the published domain. Set the NODE_VERSION environment variable to 24 or later in the Pages project; the default Node version may be older than the engine allows.
Setup on Cloudflare Pages
- In the Cloudflare dashboard, open Workers & Pages and choose Create → Pages → Connect to Git.
- Select the repository.
- Configure the build:
- Framework preset: None
- Build command:
npx mizzen build . --out dist - Build output directory:
dist
- Save and deploy.
To catch a diagnostic before Pages publishes, make the build command npx mizzen check . && npx mizzen build . --out dist. Cloudflare Pages rebuilds on every push.