Setup

Install the required tools and dependencies for Crow CI development.

Required Tools

Tool	Purpose	Notes
Go	Backend	Latest stable version
Bun	Frontend	Node.js alternative
Just	Task runner	Modern make alternative
Docker	Containers	podman not yet supported
golangci-lint	Go linting
prettier	Code formatting
pre-commit	Git hooks	Optional but recommended

Installation

1. Install Go Dependencies

Once just is installed, run:

just install-dev-deps

Note

This installs Go-related dependencies only. You’re responsible for installing other tools.

2. Install Frontend Dependencies

cd web
bun install

3. Setup Pre-commit Hooks (Optional)

pre-commit install
pre-commit install --hook-type pre-push

The pre-push stage cross-compiles for linux (GOOS=linux go build) to catch OS-gated typecheck and build errors before they reach CI.

Alternative: Dev Containers

If you prefer not to install dependencies locally, use the provided .devcontainers.json with:

• VS Code Dev Containers
• DevPod
• GitHub Codespaces

Verify Installation

# Check Go
go version

# Check Bun
bun --version

# Check Just
just --version

# Run linters
just lint