#ssg #static-site-generator #markdown #cli #markdown-html #hot-reload

app rustic-ssg

A simple, efficient static site generator written with Rust

4 releases

0.0.22 Nov 21, 2024
0.0.21 Nov 21, 2024
0.0.3 Nov 29, 2024
0.0.2 Nov 16, 2024
0.0.1 Nov 12, 2024

#201 in Web programming

Download history 101/week @ 2024-11-08 263/week @ 2024-11-15 100/week @ 2024-11-22 119/week @ 2024-11-29 10/week @ 2024-12-06

497 downloads per month

Apache-2.0

30KB
659 lines

Rustic 🌲

Rustic is a fast and minimalistic static site generator built with Rust. Create stunning websites with simplicity, flexibility, and lightning-fast performance.


🚀 Features

  • Dynamic Markdown to HTML conversion with templating support.
  • Lightning-fast builds leveraging Rust's performance.
  • Live preview server with hot reload.
  • Customizable themes and templates.
  • Simple CLI for seamless workflows.

📥 Installation

1. Install via Cargo

Ensure you have Rust installed, then run:

cargo install rustic-ssg

2. Download Prebuilt Binaries

Download prebuilt binaries from the Releases Page.
Add the binary to your system PATH to use it globally.

3. Build from Source

Clone the repository and build using Cargo:

git clone https://github.com/your-username/rustic-core.git
cd rustic-core
cargo build --release

Move the resulting binary (target/release/rustic) to a directory in your PATH.


🛠️ Usage

Commands

Command Description
rustic init Initialize a new Rustic project.
rustic build Generate the static site in the output/ folder.
rustic serve Start a local server with hot reload.
rustic clean Remove the output/ directory.
rustic help Display command usage and options.

Example Workflow

  1. Initialize a project:
    rustic init
    cd my-rustic-site
    
  2. Build the site:
    rustic build
    
  3. Preview locally:
    rustic serve
    
  4. Clean the build:
    rustic clean
    

✨ Documentation

Detailed guides and examples are available in the Documentation.


🌍 Community


📜 License

Rustic is open-source software, licensed under the Apache-2.0 License.

Dependencies

~12–22MB
~323K SLoC