Getting Started

Installation🔗

macOS and Linux:

curl -sSf https://dogma.ws/install.sh | sh

Windows:

irm https://dogma.ws/install.ps1 | iex

The installer downloads the latest release from the Dogma registry and adds dogma to ~/.dogma/bin. Add that directory to your PATH if prompted.

Verify the installation:

dogma --version

Create a project🔗

dogma init my-project
cd my-project

dogma init creates:

my-project/
  dogma.toml    # Project manifest
  src/
    main.dg     # Entry point

The generated dogma.toml:

[package]
name = "my-project"
version = "0.1.0"

[dependencies]

Add a dependency🔗

dogma:core is a built-in virtual package — no registry download required. It provides println, push, str, and other essentials. See the stdlib reference.

dogma add dogma:core
dogma install

Write a script🔗

Edit src/main.dg:

import { println } from "dogma:core"

fn main() {
    println("Hello, Dogma!")
}

Run it🔗

dogma run src/main.dg

Expected output:

Hello, Dogma!

Next steps🔗