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.