just
just is a command runner used throughout Angzarr. It provides consistent task execution across the project.
Installation
Section titled “Installation”# Via cargocargo install just
# macOSbrew install just
# Debian/Ubuntusudo apt install justCore Commands
Section titled “Core Commands”| Command | Description |
|---|---|
just build | Build the framework |
just check | Fast compile check |
just test | Run unit tests |
just fmt | Format code |
just lint | Run clippy lints |
just watch | Start bacon (background checker) |
Cluster Management
Section titled “Cluster Management”| Command | Description |
|---|---|
just cluster-create | Create Kind cluster with local registry |
just cluster-status | Show cluster and registry status |
just cluster-delete | Delete Kind cluster |
just nuke-deploy | Delete everything, rebuild from scratch |
Deployment (Skaffold)
Section titled “Deployment (Skaffold)”| Command | Description |
|---|---|
just deploy | Full deployment: cluster + infra + build + deploy |
just dev | Watch mode: auto-rebuild on file changes |
just fresh-deploy | Regenerate protos, bust caches, rebuild |
Testing
Section titled “Testing”| Command | Description |
|---|---|
just test | Run unit tests |
just integration | Run integration tests |
just acceptance | Run acceptance tests |
just test-interfaces | Run interface contract tests (SQLite) |
just test-interfaces-postgres | Run interface tests against PostgreSQL |
just test-interfaces-all | Run interface tests against all backends |
Example-Specific Commands
Section titled “Example-Specific Commands”# Access example commandsjust examples build # Build all examplesjust examples test # Test all examplesjust examples fmt # Format all examplesNext Steps
Section titled “Next Steps”- just Overlays — Platform-specific justfile patterns
- Getting Started — Full CLI reference