Ship Static site in ~2 minutes.

Why Percher fits

• Static apps run on Percher's slim Caddy image — a few MB, instant cold start, no Node process to wake up.
• Auto SSL via Let's Encrypt, gzip + zstd compression, and HTTP/3 (h3) come for free with every deploy.

Quick start

bunx percher create my-app --template static
cd my-app
bunx percher publish

The first command scaffolds a working Static site project plus a percher.toml. Publish builds and deploys it, then prints the live URL.

percher.toml

The canonical config for a Static site app on Percher. bunx percher init generates this automatically when it detects Static site in your project.

[app]
name = "my-site"
runtime = "static"

Common gotchas

• The static runtime serves pre-built files only — it rejects a `[build].command`. If you need a build step (Vite, Astro, Eleventy), use `runtime = "docker"` with a multi-stage Dockerfile instead.
• Files are served from the project root by default; set `[build].output = "dist"` (or similar) only if the assets live in a subdirectory.

Related docs

• Quick start →
• percher.toml reference →