> Cinder 0.1.0 documentation: Toolchain
> Canonical page: https://cinder.ash10.dev/docs/toolchain/ · Source: `docs/TOOLCHAIN.md` in the engine repository (engine commit 47c9352, imported 2026-11-09)
> Index of every page for agents: https://cinder.ash10.dev/llms.txt

# Toolchain

Every version below is pinned. Changing one requires an ADR and a green CI run.

## Mojo

| Item | Value | Verified |
|---|---|---|
| Mojo | `1.2.0` (compiler build `2016d0cd`), released 2026-10-22 | `pixi run mojo --version` in the toolchain container, 2026-11-08 |
| Channel | `https://conda.modular.com/max/` then `conda-forge` | pixi.toml |
| Pin | `mojo = "==1.2.0"` in `pixi.toml` | pixi.lock |

Nightlies are never used. The newest stable on 2026-11-08 was 1.2.0; the nightly channel offered
`1.3.0.dev2026110805`, which is excluded.

## Environment and native build

| Tool | Version | Source |
|---|---|---|
| pixi | `v0.63.2` (pinned through `PIXI_VERSION` in `docker/Dockerfile.toolchain`) | pixi.sh install script |
| CMake | `>=3.28,<4` from conda-forge | pixi.toml |
| Ninja | `>=1.11` from conda-forge | pixi.toml |
| C/C++ compiler (Linux) | clang from Ubuntu 24.04 (`clang` package) | docker image |
| C/C++ compiler (macOS) | Apple clang from Xcode command line tools | CI runner |
| Rust (wgpu-native only) | pinned by `third_party/wgpu-native/rust-toolchain.toml` at the vendored tag, see ADR-0004 | |

## Development host

Mojo has no Windows build. Development on the Windows host used for this project runs inside the
Linux container defined in `docker/Dockerfile.toolchain` (Ubuntu 24.04, x86-64, Mesa lavapipe for
headless Vulkan). See ADR-0007. Native Linux and macOS hosts run the same `pixi` tasks directly.

```bash
docker build -t cinder-toolchain:0 -f docker/Dockerfile.toolchain docker
docker run --rm -it -v "$PWD:/work" -w /work cinder-toolchain:0 bash
pixi install
```

## Third-party sources

All third-party code is vendored as git submodules under `third_party/`, pinned to the exact tags or
commits listed in `THIRD_PARTY_NOTICES.md`.