A fully incremental static site generator.
Dev mode = Production mode. Unlike other static site generators that take shortcuts in development (skipping minification, using original asset paths, etc.), dodeca serves exactly what you'll get in production: cache-busted URLs, minified HTML, subsetted fonts, responsive images—the works. Even font subsetting runs in dev!
This is possible because dodeca uses Salsa for incremental computation. Every transformation is a cached query. Change a file and only the affected queries re-run. First page load builds what's needed; subsequent requests are instant.
Custom template engine. Dodeca includes its own Jinja-like template engine. This gives you the power of a real language (conditionals, loops, variable interpolation) without the complexity of learning a new syntax. The engine includes rich diagnostics with line/column information for template errors.
Plugin architecture. Dodeca's plugin system (via the plugcard crate) allows extending
the build pipeline without modifying the core. Image optimization, CSS processing, syntax
highlighting, and more can be plugged in independently.
Install dodeca:
cargo install dodecaCreate a new site:
ddc init my-site
cd my-site
ddc serveThis starts a development server at http://localhost:8080 with live reload.
- Incremental builds: Only affected files are re-processed on changes
- Cache-busted URLs: Assets get unique names based on content hash
- Image optimization: Built-in image processing with responsive variants
- Font subsetting: Automatically subset fonts to used characters
- HTML minification: Minify HTML in production builds
- Template engine: Powerful, easy-to-learn Jinja-like templates
- Code execution: Execute code samples and capture output
- Link checking: Verify all links in your site
- Extensible: Plugin system for custom transformations
The dodeca workspace includes:
- dodeca: Main SSG binary (
ddcCLI) - gingembre: Template engine with rich diagnostics
- plugcard: Plugin system for extending the build pipeline
- dodeca-*: Individual plugins for various transformations
- livereload-client: WASM client for live reload in development
Build everything:
cargo xtask buildRun tests:
cargo test --workspaceBuild the documentation:
cargo doc --workspace --no-deps --openContributions are welcome! Please open issues and pull requests on GitHub.
Thanks to all individual sponsors:
...along with corporate sponsors:
...without whom this work could not exist.
Licensed under either of:
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.