Deploy a Jekyll site to LeafCloud.

Requirements

Validated with Ruby 3.2.3, Jekyll 4.4.1, and Bundler 4.0.23. The Jekyll starter uses bundle exec jekyll build to generate the _site directory.

Steps

1. Create a Jekyll project and enter its directory:

   jekyll new <project> < /dev/null
   cd <project>

2. Install the project dependencies:

   bundle install

3. Preview the deployment:

   leaf deploy --dry-run

   Expected output:

   Framework: Jekyll
   Package manager: none
   Build command: bundle exec jekyll build
   Output directory: _site
   Files: 8
   Total size: 61570 bytes
   Dry run: nothing was uploaded.

   A real deploy prints ✓ Live at <url> (<files> files, <uploaded> uploaded) instead of the final dry-run line.

What LeafCloud detects

Jekyll; bundle exec jekyll build; _site.

Common problems

No Jekyll-specific refusal was captured in validation. If the output directory contains no files, ensure the project has a page such as index.markdown and that bundle install completed successfully.

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 Jekyll 4.4.1.