Quick Start

Starting your first Sabre project

After Sabre has been successfully installed, the executable will be available for developing applications. So let's build a simple program!

Prerequisites: Sabre must be installed and available on your $PATH. See the installation guide for setup.

Create Project

Initialize a new project with sabre cm init.

Terminal
sabre cm init my-app # creates project "my-app"

This will output a folder named my-app with the following layout.

_main.sabre
_crate.jsonc

Note: Currently the cm init command is not implemented. Instead, construct the above folder layout and follow the next step for configuration.

Configuring _crate.jsonc

Similar to package.json for JavaScript, Sabre utilizes _crate.jsonc configuration files. It contains project metadata for running Sabre applications and for configuring the toolkit.

_crate.jsonc
{
    "name": "@user/my-app",
    "version": "1.0.0",
    "main": "library/_main.sabre",
    "tasks": {
        "start": "sabre run library/_main.sabre"
    }
}

Note: See the configuration section for advanced usage.

Editing library/_main.sabre

Let's update the contents of library/_main.sabre with the following code:

_main.sabre
Debug.println("Hello, World!");

Running library/_main.sabre

To now run our script, we can invoke the runtime a variety of ways:

# launch the script with an explicit path
sabre run library/_main.sabre

What Next?

Congratulations! You've built your first Sabre program. From here, the world is your oyster and you can build whatever your heart desires.

Last updated on August 15, 2026

On this page