Getting Started with Statue

January 21, 2026 · View on GitHub

Statue is a static site generator that transforms markdown files into a fast, modern website. It's built on SvelteKit and designed to be simple yet flexible.

Contribute to Statue! Built a cool component, theme, or template? Share it with the community—it only takes a single command. Learn how →

What is Statue?

Statue turns this:

---
title: My Blog Post
---

# Hello World
This is my first post!

Into a fully-styled, static website with navigation, themes, and components.

Key Concepts

📝 Content is Markdown

All your content lives in the content/ directory as .md files. The folder structure becomes your site structure:

content/blog/my-post.md  →  yoursite.com/blog/my-post
content/docs/guide.md    →  yoursite.com/docs/guide

No database, no CMS - just files.

🎨 Themes Control Style

Change your entire site's look by switching one line in src/lib/index.css:

@import "statue-ssg/themes/blue.css";

Eight built-in themes available. Learn more →

🧩 Components Build Pages

Use pre-built components to construct your pages:

<Hero />
<Stats />
<Categories {directories} />

Or create your own. See all components →

⚙️ Config Sets Globals

One file (site.config.json) controls site-wide settings:

{
  "site": { "name": "Your Site", "url": "https://yoursite.com" },
  "contact": { "email": "hello@yoursite.com" },
  "social": { "twitter": "https://twitter.com/yourhandle" }
}

Use these values anywhere with {{site.name}}. Configure your site →

📐 Templates Provide Structure

Start with different layouts:

npx statue init --template blog    # Blog-focused
npx statue init                     # Default

Learn about templates →

Project Structure

your-project/
├── content/              # Markdown content
│   ├── blog/
│   └── docs/
├── src/
│   ├── lib/index.css    # Theme imports
│   └── routes/
│       ├── +page.svelte           # Homepage
│       ├── [directory]/+page.svelte   # Directory pages
│       └── [...slug]/+page.svelte     # Content pages
├── static/              # Images, favicon
└── site.config.json     # Site configuration