Deploy an Astro site to LeafCloud.

Requirements

Validated with Node v24.22.1, Astro 7.4.2, and npm. No configuration change is required.

Steps

1. Create an Astro minimal project:

   npm create astro@latest app -- --template minimal --yes --no-git < /dev/null

   cd app

2. No config change is needed.

3. Preview the deployment:

   leaf deploy --dry-run

   Expected output:

   Framework: Astro
   Package manager: npm
   Build command: npm run build
   Output directory: dist
   Files: 3
   Total size: 1716 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

Astro; npm run build; dist.

Common problems

No Astro-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 Astro 7.4.2.