Open source · GO · BSD-3-Clause
The AI-native static site generator
Build fast, hardened sites from Markdown and SQL databases. AI runs at build time, an MCP server drives SSG from your agent, and every page ships clean Markdown for the tools that read it — a 5 000-post site builds in 2.3 seconds, with nothing sent to the browser that does not have to be.
Why ssg
Built for speed, data, documentation and the AI web
-
Builds in seconds, not minutes
A 5 000-post site builds in 2.3 seconds — 5.25× faster than the previous release, after two costs that only appeared at scale were removed. Output is byte-identical however many workers run, so a shorter CI job is the only difference.
-
Reads your database directly
MySQL, MariaDB, PostgreSQL and SQLite are content sources like any other — no export step and no glue script. Queries run read-only at build time, so the database stays behind your firewall and never sits in the request path.
-
Built for AI agents, end to end
AI runs at build time — summaries, tags and related posts, cached by content hash and never reaching the browser. An MCP server lets agents create and edit content, and every page publishes clean Markdown and an llms.txt index for the tools that read it.
-
API reference beside your guides
Point it at a JavaScript package or an OpenAPI file and the reference becomes pages of the same site, in the same search and link check as the guides. Examples run in the browser, and every REST endpoint has a Try it console.
Deploys natively to
Guides
Documentation
Every guide below is built from this repository's own docs/
folder through content_sources — this site is its own
integration test.
-
Markdown for agents & AI search
SSG is Markdown-native, so it can hand language models and AI crawlers the authored Markdown of every page instead of making them parse rendered HTML. This…
-
API documentation from code
ssg reads JavaScript and TypeScript, together with their documentation comments, and publishes the API as ordinary pages of your site. Those pages use the same…
-
API docs: languages
apidocs reads JavaScript, TypeScript declarations, Go, PHP and Python. Every reader is written in Go and built into ssg, so you install nothing: no Node, no…
-
Articles read aloud
ssg can make an article listenable in two ways. They work alone or together.
-
Typed content components
A component is a directory with a contract, and a call that carries its arguments. Content asks for a thing, with the details that make it this thing, and the…
-
Configuration reference
SSG can be configured with command-line flags or a YAML, TOML or JSON file. This guide explains the configuration model and advanced features. The exhaustive…
31 guides in total — the full directory is in the footer below.
Updates
Latest posts
-
Breadcrumbs, Honest Sitemap Dates and a Build Report
What changed in ssg 1.8.73 and 1.8.74: breadcrumbs that only link to pages that exist, a sitemap checked against Google's rules, dates in it that are true, the ssg version in templates, and a Go security fix.
-
Print a Recipe, Cook From Your Phone, Swipe Through a Story
1.8.72 adds three things a reader sees: a Print / PDF button with a recipe card, a Cook Mode that keeps the screen awake, and Google Web Stories, all built from data the post already has.
-
Three Releases Without a Post: Structured Data, Languages and a Security Fix
What changed in ssg 1.8.70, 1.8.71 and 1.8.72: recipes and FAQs as structured data without a script, a CV page, a front page per language, a newsletter Worker, and a Go security release.
-
The API Reference Belongs Next to the Guides
1.8.69 reads JavaScript, TypeScript declarations, Go, PHP, Python and OpenAPI files into pages of the same site as your guides, with examples that run in the browser and a Try it console for every endpoint.
-
Two Ways to Read an Article Aloud
1.8.65 adds a Listen button that uses the reader's own voice engine, and build-time MP3 from a TTS API you choose, with a podcast feed and a plan for when the API is down.
-
Most Websites Are Documents. Stop Shipping Them as Applications.
A phone downloads 486 KB of this site's home page, and 24 KB of it is what the generator wrote. The rest is choices. The case for static sites, measured.