Files
sukr/docs/content/_index.md
Timothy DeHerrera 8c806d1654 feat(docs): create sukr documentation site
Self-documenting docs site built with sukr itself (dogfooding):
- docs/site.toml with sukr.io base URL
- docs-specific templates with sidebar navigation
- Dark theme CSS, responsive layout
- Documentation: getting-started, configuration, features

Also: improved error chaining for better template debugging
2026-01-31 15:58:37 -07:00

854 B

title, description
title description
sukr Minimal static site compiler — suckless, Rust, zero JS

Welcome to sukr

sukr transforms Markdown into high-performance static HTML. No bloated runtimes, no client-side JavaScript, just clean output.

Why sukr?

  • Fast builds — Single Rust binary, parallel processing
  • Zero JS — Syntax highlighting at build time via Tree-sitter
  • Flexible templates — Runtime Tera templates, no recompilation
  • Monorepo-ready — Multiple sites via -c config flag

Quick Start

# Install
cargo install sukr

# Create site structure
mkdir -p content templates static
echo 'title = "My Site"' > site.toml
echo 'author = "Me"' >> site.toml
echo 'base_url = "https://example.com"' >> site.toml

# Build
sukr

Documentation

Browse the sidebar for detailed documentation on all features.