Deploy a Docusaurus site to LeafCloud.

Requirements

Validated with Node v24.22.1, Docusaurus 3.10.2, React 19.3.1, and npm. The generated classic starter needs no configuration change.

Steps

1. Create a Docusaurus classic project:

   npx --yes create-docusaurus@latest <project> classic --typescript < /dev/null

   cd <project>

2. No config change is needed.

3. Preview the deployment from the project root:

   leaf deploy --dry-run

   Expected output:

   Framework: Docusaurus
   Package manager: npm
   Build command: npm run build
   Output directory: build
   Files: 102
   Total size: 1930232 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

Docusaurus; npm run build; build.

Common problems

No Docusaurus-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 Docusaurus 3.10.2.