# cargoxx

A Cargo-style frontend for modern C++ that uses Nix as the source of truth for
dependencies and generates CMake for the build. Users author projects with C++23
modules and never touch CMake or `flake.nix` by hand.

> Status: pre-v0.1, milestone M0 (repo skeleton). Not yet usable.

See [`SPEC.md`](./SPEC.md) for the user-facing contract and
[`TECH_SPEC.md`](./TECH_SPEC.md) for the implementation plan.

## Building from source

cargoxx builds inside a Nix-managed dev shell that pins the toolchain
(Clang with C++23 modules + `import std;`, CMake ≥ 3.30, Ninja).

```sh
nix develop
cmake -B build -G Ninja -DCMAKE_BUILD_TYPE=Debug
cmake --build build
```

The resulting binary is at `build/cargoxx`.