Thanks for your interest. This project is in early alpha — the API is not stable and the public scope is summarized by the supported backends and spec-compliance matrix in README.md. Issues and PRs that fall outside the documented scope will likely be closed with a pointer to that matrix.
Requirements:
- Go 1.25+
- Docker (with the Compose v2 plugin if you touch compose code)
golangci-lintv1.64+ (brew install golangci-lintor see https://golangci-lint.run/welcome/install/)
git clone git@github.com:crunchloop/devcontainer.git
cd devcontainer
make test # unit tests
make test-integration # integration tests (requires Docker daemon)
make lint- Unit tests live next to the code (
*_test.go). - Integration tests live under
test/integration/and are gated by//go:build integration. They require a real Docker daemon and may pull images on first run.
- Keep PRs focused; one logical change per PR.
- Run
make lint testlocally before pushing. - Add or update tests for behavior changes.
- Reference the relevant design record or README capability in the PR description when applicable.
Bug reports should include the Go version, Docker version, and (if relevant)
a minimal devcontainer.json that reproduces the problem.