Deploy a static HTML site to LeafCloud.

Requirements

No build tools, runtimes, or package managers are required. Any folder containing a root index.html can be deployed directly.

Steps

1. Create a project directory with an index.html file:

   mkdir <project>
   cd <project>
   cat << 'EOF' > index.html
   <!DOCTYPE html>
   <html lang="en">
   <head>
     <meta charset="UTF-8">
     <title>Plain HTML</title>
   </head>
   <body>
     <h1>Hello, LeafCloud!</h1>
   </body>
   </html>
   EOF

2. No build configuration or build step is needed.

3. Preview the deployment:

   leaf deploy --dry-run

   Expected output:

   Framework: static HTML
   Package manager: none
   Build command: none
   Output directory: .
   Files: 1
   Total size: 153 bytes
   Dry run: nothing was uploaded.

   A real deploy replaces the final dry-run line with:

   ✓ Live at <url>  (<files> files, <uploaded> uploaded)

What LeafCloud detects

static HTML; build command none; ..

Common problems

• No supported static-site framework detected. Use --dir to select a built output directory. — ensure index.html exists in the directory where leaf deploy is run, or specify the folder with --dir <path>.

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 static HTML.