rust-coal 🚂

A static HTML development tool, built with Rust

Who is this for?

Those that want to generate a basic static HTML site, with perhaps 1-10 pages, and do not want to maintain layouts, navigation elements, and footers across multiple files.

If you need programmatic components, then it would be better to utilize a more hands-on system like GatsbyJS, React Static, or a Content Management System (CMS) such as WordPress.

Just like in a typical Jamstack solution, the static HTML output can be easily served on GitHub Pages, Firebase Hosting, and a number of other places. Also see about upcoming Docker support below.

Documentation

See the Coal Docs for installation steps and detailed instructions.

Features

• Blazing Fast 🚀 (Seriously - its fast)
• Zero config 📄
• Convention Over Configuration 💜
• Batteries Included 🔋
• Standard HTML 🌠
• HTML,CSS,JS minification 🗜️
• Asset Bundling 📦
• Supports static folder 🎓
• Supports images/fonts 📦
• Local Dev Server ⚒️
• Basic Nested CSS ~SCSS :nail_care: Using Grass
• Smart Execution During Local Dev ✨ (No need to restart server for any changes)
• Leverages Locomotive Emoji 🚂

crate

https://crates.io/crates/coal

Platforms / Technologies

• Rust
• Cargo

Current Version

v1.0.0

Showcase

Sites using coal to generate simple static HTML websites - Add yours via PR:

• Coal Docs - dogfooding FTW
• CameronManavian.com
• Rust Lang Los Angeles

Future Features

For feature requests, please see this issue.

Some ideas (check issue for latest list):

• Docker build script 🐋
• Custom reusable components (Like React or Vue) ⚛️
• Uglification of JS 🧟
• Option to produce external files for CSS and JS 🎁

Why Coal?

The name coal is just a shortened version of the word coalesce.

co·a·lesce /ˌkōəˈles/ verb come together to form one mass or whole.