Deploy a React + Vite site to LeafCloud.

Requirements

Validated with Node v24.22.1, React 19.3.1, React DOM 19.3.1, Vite 8.3.5, @vitejs/plugin-react 6.1.2, and npm. No configuration change is required.

Steps

1. Create the official React starter:

   npm create vite@latest app -- --template react < /dev/null
   cd app
   npm install < /dev/null

2. No config change is needed.

3. Preview the deployment:

   leaf deploy --dry-run

   Expected output:

   Framework: React + Vite
   Package manager: npm
   Build command: npm run build
   Output directory: dist
   Files: 8
   Total size: 267450 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

React + Vite; npm run build; dist.

Common problems

No React + Vite-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 React 19.3.1 and Vite 8.3.5.