Deploy an Eleventy site to LeafCloud.

Requirements

Validated with Node v24.22.1, Eleventy 3.1.7, and npm. The minimal project uses .eleventy.js to set the input folder to src and output folder to _site.

Steps

1. Create a minimal project with a package.json containing Eleventy and a build script that runs eleventy. Add .eleventy.js:

   module.exports = function (eleventyConfig) {
     return { dir: { input: "src", output: "_site" } };
   };

   Add a page such as src/index.md, then install dependencies with npm install.

2. No additional configuration is needed.

3. Preview the deployment from the project root:

   leaf deploy --dry-run

   Expected output:

   Framework: Eleventy
   Package manager: npm
   Build command: npm run build
   Output directory: _site
   Files: 1
   Total size: 61 bytes
   Dry run: nothing was uploaded.

What LeafCloud detects

Eleventy; npm run build; _site.

Common problems

No Eleventy-specific refusal was captured in validation.

For agents

Run leaf deploy --dry-run --json first. Check the exit code and stop if the JSON contains "error". After a successful dry run, run leaf deploy --json --yes. Never print credentials.

Validated on 2026-10-23 with Eleventy 3.1.7.