Development

Magistr is developed as a Rust workspace. Start with the repository’s development guide, then use the commands below from the checkout.

Build and test

cargo fmt --all
cargo check --workspace --all-targets
cargo nextest run --workspace
cargo clippy --workspace --all-targets -- -D warnings

For website-only changes:

cd apps/website
npm ci
npm run build
node tests/build-output.mjs

The native magistr_gate command records checks in the project’s ship lifecycle. A docs-only cycle can use focused verification; a code or packaging change uses the full configured gates.

Contribution boundaries

Keep the cockpit independent of terminal protocols and keep the desktop independent of magistr-tui. Update architecture docs when a boundary or ownership decision changes. Use the contributing guide for review expectations.