About Spaz
What is Spaz?
Spaz is a modern take on static site generation. It’s built on a simple philosophy:
Write markdown. Get a beautiful, fast SPA. Done.
No templates to learn. No configuration files. No JavaScript framework overhead. Just clean markdown files that become an interactive website.
Why Spaz Exists
Static site generators have been around for years, but they’ve grown complex:
- Jekyll needs Ruby and lots of configuration
- Hugo is powerful but has a steep learning curve
- Next.js is overkill for a blog or documentation site
- Gatsby requires GraphQL and a plugin ecosystem
Spaz cuts through the noise. It’s laser-focused on one thing: converting markdown to a fast, interactive website.
Key Principles
1. Simplicity
No configuration. No templates. No learning curve. Run spaz and get a complete site.
2. Performance
Generated sites are static HTML—instantly fast. Client-side navigation adds interactivity without sacrifice.
3. Zero Dependencies
The generated site has no runtime dependencies. Pure HTML, CSS, and optional WebAssembly.
4. Flexibility
Works as-is, but can be customized by editing the Rust source. Perfect for developers.
When to Use Spaz
Spaz is ideal for:
- Documentation sites - Clean, simple, fast
- Blogs - Write in markdown, publish instantly
- Marketing sites - Fast loading, great for SEO
- Knowledge bases - Organized by directory structure
- Personal websites - Simple and under your control
Spaz is not for:
- Dynamic content - Use a backend + database for that
- Complex sites - Too many features needed
- Content management - No CMS integration
- Non-developers - Requires running command-line tools
Technical Stack
- Rust: Fast, reliable, no runtime overhead
- pulldown-cmark: Rock-solid markdown parsing
- WebAssembly: Optional optimized routing
- Plain JavaScript: Fallback for maximum compatibility
The Goal
To prove that a great static site generator doesn’t need to be complicated. Spaz gets out of your way and lets you focus on writing content.
Links
- Getting Started - Install and create your first site
- Usage Guide - Complete usage reference
- Architecture - How it works under the hood
- FAQ - Common questions and answers