Plain HTML in, fast static sites out. One binary. No framework, no Node, no template language to learn — just HTML files and a handful of tags.
statico new my-site # or: mkdir my-site && cd my-site && statico init
cd my-site
statico dev # http://localhost:3000, live reload
statico build https://my-site.comStatico started as a Rust rewrite of DevDojo's Static
and still builds Static projects unchanged (static.json works as-is).
- Plain HTML. Pages are HTML files; layouts and includes are HTML files. Five tags:
<layout>,<include>,<ForEach>,<If>,<page>. - One binary, no Node. Tailwind (v3 and v4, auto-detected) and esbuild are fetched as standalone binaries on first use and cached.
- Batteries included. Markdown with syntax highlighting, pagination, tag pages, Atom feeds, SEO and Open Graph tags, sitemap, search index, image dimensions and lazy loading, minification, fingerprinted assets.
- Errors that tell you where.
pages/blog/index.html:12: <ForEach> is never closed [S001]— in the terminal, in the browser, and as JSON. - Built for AI agents too.
--jsonon every command,statico checkas a definition of done,statico addscaffolding, anAGENTS.mdgenerator,llms.txtand markdown copies of every post. - Fast. Pages render in parallel; a 1,000-post blog with syntax highlighting builds in ~1.5 s on a 2-core VM.
cargo install statico-cli # binary: staticoPrebuilt binaries, a curl | sh installer, an npm wrapper and a Homebrew
formula are set up in packaging/ and publish with each tagged release.
pages/index.html → /
pages/about.html → /about/
pages/blog/index.html → /blog/ (+ /blog/page/2/ …)
pages/blog/[content].html → template for content/blog/*.md
pages/tags/[tag].html → /tags/<tag>/ for every tag
content/blog/hello.md → /blog/hello/
layouts/main.html → page shell with {slot}
includes/header.html → <include src="header.html" />
collections/team.yaml → <ForEach collection="team">
assets/css/main.css → Tailwind, compiled and fingerprinted
public/ → copied as-is
<!-- pages/blog/index.html -->
<layout src="main.html" title="Blog">
<ForEach content="blog" as="post" orderBy="date, desc" paginate="10">
<article>
<a href="{post.url}">{post.title}</a>
<time>{post.date|date:"%B %-d, %Y"}</time>
<If condition="post.tags contains 'news'"><span>News</span></If>
</article>
</ForEach>
<If condition="pagination.has_next"><a href="{pagination.next_url}">Older posts</a></If>
</layout><!-- layouts/main.html -->
<!DOCTYPE html>
<html lang="en">
<head>
<title>{title} · {site.name}</title>
{seo}
{tailwindcss}
</head>
<body>{slot}</body>
</html>The full reference ships in the binary: statico docs, statico docs loops,
statico docs --all, or read the documentation site.
| Command | |
|---|---|
statico new <dir> [--template blog|docs|owner/repo|./dir] |
new site from a template |
statico init |
turn the current folder into a site |
statico dev [--port] [--open] |
dev server, live reload, error overlay |
statico build [url] [--watch] |
production build into _site/ |
statico serve |
preview the build like a static host |
statico check [--strict] |
broken links and anchors, alt text, titles, unresolved placeholders |
statico add page|post|include|layout|collection |
scaffold files |
statico routes |
every URL → source file |
statico docs [topic] · statico explain S101 |
offline reference and error codes |
statico diff <old> <new> |
compare two builds (verify upgrades change nothing) |
statico agents |
write AGENTS.md + CLAUDE.md for coding agents |
statico schema |
JSON Schema for statico.json |
Every command accepts --json and -C <dir>. Exit code 1 means errors.
Agents work best with a terminal, plain files and fast feedback. Statico gives them:
AGENTS.md(fromstatico new,statico initorstatico agents) — the project's conventions in one page.statico check --json— structured errors withcode,file,urlandmessage; zero errors means done.statico add …— files created in the right place with working boilerplate.statico docs --all/statico explain— documentation that matches the installed version.- Readable output for other AIs —
llms.txt,llms-full.txt,/post.mdcopies, and the dev server answersAccept: text/markdown.
There is no MCP server on purpose: agents that can run shell commands get everything through the CLI, with fewer tokens. See docs/RESEARCH.md.
Everything keeps working: static.json, <layout>, <include>, <ForEach>,
<If>, {tailwindcss}, { url() }, [content].html, window.toc,
{static_content_element}, and statico new my-site --blog. Differences you'll
notice are fixes:
- Tailwind v3 projects (all official templates) now compile correctly.
<If>conditions are evaluated safely instead of as JavaScript.pages/404.htmlbuilds to/404.html.- Builds fail loudly, with every error listed, instead of half-succeeding.
- Documentation, built with Statico from the
docstemplate - docs/REFERENCE.md — complete syntax and configuration (the source of the site's reference pages)
- ROADMAP.md — what's done, what's next, and why
- docs/RESEARCH.md — what users of other generators are missing
- packaging/README.md — releases and distribution
cargo test # unit tests + end-to-end fixture
cargo clippy --all-targets -- -D warningsMIT. Statico began as a rewrite of Static by Tony Lea / DevDojo.