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