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
- In the Netlify dashboard, choose Add new site → Import an existing project and pick the repository.
- Set the build settings:
- Build command:
npx mizzen build . --out dist - Publish directory:
dist
- Build command:
- Set the Node version to 24 or later, with a
NODE_VERSIONenvironment variable or a.nvmrcfile. - 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.