Deploy to Netlify

1 minute read

Deploy to Netlify

Netlify runs the build 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.

Setup on Netlify

  1. In the Netlify dashboard, choose Add new site → Import an existing project and pick the repository.
  2. Set the build settings:
    • Build command: npx mizzen build . --out dist
    • Publish directory: dist
  3. Set the Node version to 24 or later, with a NODE_VERSION environment variable or a .nvmrc file.
  4. Deploy the site.

To catch a diagnostic before Netlify publishes, make the build command npx mizzen check . && npx mizzen build . --out dist. Netlify rebuilds on every push.

View Markdown

Use with an agent
View Markdown

Open in