Contributing

Adding a feature or command

See docs/adding-a-command.md for a full walkthrough including middleware methods, cobra commands, flags, and tests.

See docs/testing.md for setup, environment variables, and test patterns.

Quick start:

make be-start          # start the local backend
go test ./...          # run all tests
make be-stop

make format            # gci + goimports + shfmt
make lint              # golangci-lint + shellcheck

Always run both before submitting a PR.

Each PR should include a changelog entry:

make new-changelog-entry

This runs changie via docker and creates a file in changelog/unreleased/.