Initial commit

README.md

@@ -0,0 +1,23 @@
+# 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`.