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🔗
- Language reference — types, control flow, functions
- Stdlib reference — built-in packages
- Embedding guide — embed Dogma in a Rust application
- CLI reference — all CLI subcommands