🚀 Getting Started with Mustela

Mustela is designed for extreme speed and simplicity. The entire process from installation to your first published site takes less than a minute.

1. Installation

Mustela is distributed as a single, 1.3 MB statically linked binary with zero dependencies.

# Download the stable binary
curl -L https://mustela.vercel.app/linux/amd64/mustela -o mustela

# Make it executable
chmod +x mustela

# Move it to your PATH
sudo mv mustela /usr/local/bin/

2. Initialize Your Project

Create a new directory and scaffold your project structure. Mustela offers two main paths depending on your frontend stack:

Mustela will generate the necessary directories (config/, theme/, content/) and, in the case of the Vite preset, a pre-configured package.json and vite.config.js ready for your asset pipeline.

3. Create Your First Post

Create a file named content/index.md. You can include metadata directly at the top of the file.

meta do
  title: My First Post
end

# Hello World!
This is my first website generated with Mustela.

4. Build and Watch

Now, build your project. Thanks to the stateful DSL engine, this happens almost instantly.

# Run a one-time build
mustela build

# Enable development mode with automatic rebuilds (inotify)
mustela watch