Community

Development setup

The root workspace contains the current Rust CLI, shared chunking core, website, and npm package. No database or server is required.

Ignore the quarantined backend

legacy/backend-crates is historical research and is excluded from the root Cargo workspace. PostgreSQL, Redis, Docker Compose, and a Dits server are not prerequisites for current development.

Prerequisites

Rust stable, plus nightly rustfmt for the repository format check.
Node.js 20 and npm.
Git.
FUSE development libraries only for optional all-feature VFS builds.

Build

git clone https://github.com/byronwade/dits.git
cd dits
npm ci
cargo build --locked -p dits
npm --workspace apps/web run build

Run locally

cargo run --locked -p dits -- --help
npm --workspace apps/web run dev

Verify

cargo +nightly fmt --all -- --check
cargo +stable clippy --locked --all-targets --all-features -- -D warnings
cargo test --locked --workspace
npm --workspace apps/web run lint
npm --workspace apps/web run test:ci
bash scripts/check-cli-docs.sh
bash scripts/check-product-truth.sh

See the contributing guide for correctness, format, evidence, and pull-request expectations.