BersisSe/rustic-core

Rustic - A lightweight, high-performance static site generator in Rust, with Markdown support, customizable templating, and fast build speeds.

โ˜… 2Forks 0RustGitHub โ†—Compare

README

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/BersisSe/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.

Contributors

BersisSe

Issues