# DCR — Dexoron Cargo Realization
**A Cargo-style build tool for C/C++ projects**
[](https://github.com/dexoron/dcr/actions/workflows/ci.yml)
[](https://github.com/dexoron/dcr/releases/latest)
[](https://github.com/dexoron/dcr/releases)
[](https://aur.archlinux.org/packages/dcr)
[](https://crates.io/crates/dcr)
[](https://github.com/dexoron/homebrew-dexoron)
[](https://github.com/dexoron/dcr/stargazers)
[](LICENSE)
---
## Why DCR?
- **No boilerplate** — one config file, predictable structure
- **Cargo-like workflow** — `build`, `run`, `clean`, `test`, `add`
- **Cross-compilation** — full target triple support with short names
- **IDE integration** — VS Code, CLion, `compile_commands.json` out of the box
- **Dependencies** — path, git, and registry-based with lock file
---
## Installation
| Arch Linux (AUR) |
```sh
yay -S dcr
```
|
| macOS/Linux(GNU) (Homebrew) |
```sh
brew tap dexoron/dexoron
brew install dcr
```
|
| Cargo (crates.io) |
```sh
cargo install dcr
```
|
| Linux / macOS (script) |
```sh
curl -fsSL https://dcr.dexoron.su/install.sh | bash
```
|
| BSD (script) |
```sh
curl -fsSL https://raw.githubusercontent.com/dexoron/dcr/dev/install_bsd.sh | bash
```
|
| Windows (PowerShell) |
```powershell
irm https://dcr.dexoron.su/install.ps1 | iex
```
|
| From source |
```sh
git clone https://github.com/dexoron/dcr.git
cd dcr && cargo build --release
ln -sf "$PWD/target/release/dcr" ~/.local/bin/dcr
```
|
---
## Quick Start
```sh
dcr new hello
cd hello
dcr run
```
**Project structure:**
```
hello/
├── dcr.toml # project config
└── src/
└── main.c
```
---
## dcr.toml Example
```toml
[package]
name = "hello"
version = "0.1.0"
[build]
language = "c"
standard = "c11"
compiler = "clang"
kind = "bin"
[dependencies]
```
---
## Base Commands
| Command | Description |
|---|---|
| `dcr new ` | Create a new project |
| `dcr init` | Initialize current directory |
| `dcr build [--release]` | Build the project |
| `dcr run [--release]` | Build and run |
| `dcr clean` | Remove build artifacts |
other in [docs/](docs/) and `dcr --help`
---
## Platforms
| OS | x86_64 | aarch64 | armv7 | i686 | riscv64 | GNU | Musl | MSVC | MinGW |
|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
| Linux | ✅ | ✅ | ❌ | ❌ | ❌ | ✅ | ✅ | ❌ | ❌ |
| macOS | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Windows | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | ✅ |
| FreeBSD | ✅ | ⚠️ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
| OpenBSD | ✅ | ⚠️ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
| NetBSD | ✅ | ⚠️ | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ |
✅ officially supported · ⚠️ community / best-effort · ❌ not supported
---
## Documentation
Full docs at **[dcr.dexoron.su](https://dcr.dexoron.su)** or in the [`docs/`](docs/) directory.
---
## Contributors
| | Name | Role | GitHub |
|:---:|---|---|---|
| 👤 | Dexoron (Bezotechestvo Vladimir) | Maintainer, Creator | [@dexoron](https://github.com/dexoron) |
| 👤 | Kai | Maintainer | [@peoplemiau1](https://github.com/peoplemiau1) |
---
## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md). Before a PR:
```sh
cargo fmt --all
cargo clippy --all-targets --all-features -- -D warnings
cargo test
```
---
GPL-3.0 — see [LICENSE](LICENSE)
Made with ❤️ by [Dexoron](https://github.com/dexoron) and contributors.