Overview

Mustela is a lightweight Static Site Generator (SSG) that dominates in performance through its custom DSL. It is built entirely in V (Vlang).

The stable version was forged over a 70-day development cycle, with a relentless focus on optimization—specifically by minimizing memory allocations via pointer passing, ensuring data is never unnecessarily copied.

Architectural Philosophy

If you are interested in how Mustela achieves its performance, I have detailed the core concepts in our technical documentation. The engine is structured as a platform architecture communicating via an event bus, effectively implemented as an RPC system. While the underlying source code may feel like a high-performance game engine, it remains a fully robust and deterministic CLI tool.

🔗 Explore more in the Core Concepts documentation

Key Features

• Zero-Copy Pipeline: Strictly avoids redundant memory allocations for peak performance.
• Unix-First: Leverages native syscalls for sub-millisecond throughput.
• Deterministic: Guaranteed output stability even in hostile, high-pressure environments.
• Zero-Dependency: A single, tiny, statically linked binary. No node_modules, no overhead.

Compilation

Mustela is written in V (Vlang).

⚠️ Critical Note on Compatibility

Due to the rapid development cycle of the V language, syntax and internal APIs can change frequently. To ensure successful compilation, this project is currently tested against V version 0.5.1 (commit 0c3183c).

Using newer versions of the compiler may lead to "incorrectly implements method" errors or build failures. If you encounter issues, please revert to the specified commit.

To build the production-ready binary, run:

v -prod .

Engineering Insights & Architecture

Mustela is designed as a platform, not just a static site generator. Its core modularity relies on an Event Bus architecture, ensuring that components remain decoupled and replaceable.

If you are diving into the source code and find the architectural choices unfamiliar, the following technical deep-dives explain the reasoning behind Mustela's structure:

• Building Modular Applications with V: An exploration of composition roots, state management, and avoiding global variables.
• Architecture vs. Chaos: Practical application of the Interface Segregation Principle in a high-pressure environment.
• DSL Engineering: The Watchmaker's Discipline: A guide to the Lexer, Parser (Pratt method), and AST structures (Czech language; Google Translate recommended).

The engine relies on a custom DSL for content manipulation, allowing for recursive template composition. Treat the codebase as a system of independent blocks—this design ensures long-term maintainability and performance.

Mustela Web

The official Mustela website is itself a Mustela project. The source code is fully open-source and hosted on Codeberg:

👉 mustela/web (Codeberg)

Getting Started

For detailed documentation on the Mustela engine and its unique DSL, please visit the official site:

👉 Getting Started with Mustela

License

This project is licensed under the MIT License - see the LICENSE file for details.