DocsEngine design

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.

View as MarkdownSource: docs/TOOLCHAIN.md