Getting Started

Install

# Requires Rust 1.85+ (edition 2024)
git clone rad:zxV5qatQ9Z2WvnTef3xaa8ryYLXE thermite-ssg
cd thermite-ssg
cargo build --release

The binary lands at ./target/release/thermite. Put it wherever you keep your tools.

CLI

thermite [OPTIONS]
  -s, --source <PATH>   Site source directory     [default: .]
  -o, --output <PATH>   Output directory           [default: _site]
  -c, --config <PATH>   Config file path           [default: thermite.toml]
  -h, --help            -V, --version

No subcommands. No watch mode. No dev server. Build, then serve however you want.

Create a site

my-site/
├── content/          # .md or .markdown files
│   ├── index.md      → _site/index.html
│   ├── about.md      → _site/about/index.html
│   └── sub/
│       └── page.md   → _site/sub/page/index.html
├── templates/        # Tera .html templates
├── static/           # Copied as-is to output root
└── thermite.toml

Create a thermite.toml:

title = "My Site"
base_url = "https://example.com"
description = "Built with Thermite"

Add a content/index.md with some Markdown, a templates/base.html, and run:

thermite --source my-site/ --output _site/

That's it. Open _site/index.html.