Skip to content
labelle

Installation

Requirements

Section titled “Requirements”
  • Zig 0.15.2+ - Download
  • labelle-cli - Command-line tool for project management

Install labelle-cli

Section titled “Install labelle-cli”
Terminal window
# Coming soon: binary releases
# For now, build from source:
git clone https://github.com/labelle-toolkit/labelle-cli
cd labelle-cli
zig build -Doptimize=ReleaseFast

Add the binary to your PATH or copy to /usr/local/bin.

Create a New Project

Section titled “Create a New Project”
Terminal window
labelle init my-game
cd my-game

This creates a project with:

  • project.labelle - Project configuration
  • scenes/ - Scene definitions
  • prefabs/ - Reusable entity templates
  • scripts/ - Game logic

Build and Run

Section titled “Build and Run”
Terminal window
labelle run

Platform-Specific Setup

Section titled “Platform-Specific Setup”

macOS

Section titled “macOS”

No additional setup required.

Linux

Section titled “Linux”

Install development libraries:

Terminal window
# Ubuntu/Debian
sudo apt install libgl1-mesa-dev libx11-dev


# Fedora
sudo dnf install mesa-libGL-devel libX11-devel

Windows

Section titled “Windows”

No additional setup required.

Next Steps

Section titled “Next Steps”