Rustyll is a blazing fast static site generator written in Rust. It’s a drop-in replacement for Jekyll that offers dramatic performance improvements through parallel processing. Rustyll takes text written in your favorite markup language and uses layouts to create a static website. You can tweak the site’s look and feel, URLs, the data displayed on the page, and more.
Why Choose Rustyll?
- Lightning Fast: 10-100x faster than Jekyll thanks to Rust and parallel processing
- Fully Compatible: Works with existing Jekyll sites with no modifications needed
- Modern Features: Parallel builds, aggressive caching, and memory optimization
- Rust-powered: Built on Rust’s speed, memory safety, and thread safety
- Jekyll-familiar: Uses the same project structure and Liquid templates
Prerequisites
Rustyll requires the following:
- Rust version 1.75 or higher
- Cargo (comes with Rust)
See Requirements for guides and details.
Instructions
- Install all prerequisites.
- Install Rustyll using Cargo.
cargo install rustyll
- Create a new Rustyll site at
./myblog
.rustyll new myblog
- Change into your new directory.
cd myblog
- Build the site and make it available on a local server.
rustyll serve
- Browse to http://localhost:4000
Pass the --livereload
option to serve
to automatically refresh the page with each change you make to the source files: rustyll serve --livereload
For even faster build times, enable parallel and incremental builds: rustyll serve --livereload --incremental --threads=auto
Migration from Jekyll
If you have an existing Jekyll site, migration is simple:
- Install Rustyll
- Navigate to your Jekyll site directory
- Run
rustyll serve
That’s it! Rustyll will automatically detect and build your Jekyll site, typically 10-100x faster than Jekyll would.
Performance Comparison
Site Size | Jekyll Build Time | Rustyll Build Time |
---|---|---|
Small (50 pages) | 3.5s | 0.3s |
Medium (500 pages) | 32.0s | 1.8s |
Large (5000 pages) | 5m 20s | 9.5s |
See Parallel Builds for more information on Rustyll’s performance features.
If you encounter any errors during this process, check that you have installed all the prerequisites in Requirements. If you still have issues, see Troubleshooting.
Installation varies based on your operating system. See our guides for OS-specific instructions.