rats-ssg

Table of Contents

• Who Is This For?
• Why rats-ssg?
  • C-Level Performance, Pythonic Syntax
  • Macro-Driven Template Logic
  • Memory Safety Without GC
• Quick Start
• Features
• License

Nimble, fast-moving static site generation in Nim. "Rats" — Scurrying through your content with unmatched speed. A generator that compiles to C for native performance on any platform.

Who Is This For?

• Systems Engineers targeting Minix, Android, or iOS who need tiny, high-performance binaries.

• Python developers looking for a "compiled Python" experience with macro-powered templates.

• Architects needing a generator that can target WASM and C simultaneously from a single source.

Why rats-ssg?

C-Level Performance, Pythonic Syntax

rats-ssg provides the raw speed of a C-compiled engine with the expressive power of Nim’s syntax. It is the primary choice for Edge tech where binary size is a premium and execution must be instantaneous.

Macro-Driven Template Logic

Templates in rats-ssg are processed via Nim’s powerful macro system. This allows for compile-time generation of HTML structures, ensuring that the final binary contains the "baked-in" logic for your site, reducing runtime overhead to zero.

Memory Safety Without GC

By leveraging Nim’s ARC/ORC memory management, rats-ssg operates without the "stop-the-world" pauses of traditional garbage collectors. This ensures deterministic performance during massive site syntheses.

Quick Start

# Install Nim via asdf
just setup

# Compile the SSG to a native binary
just compile

# Build the site at scurry-speed
just build

Features

• Native Compilation - Targets C, C++, and Objective-C.

• Zero-Overhead Templates - Macro-optimised at compile time.

• Podman-First - Standard containerised toolchain for cross-compilation.

• Accessibility - Native support for BSL, GSL, ASL, and Makaton.

License

AGPL-3.0-or-later