.github/RELEASING.md

Releasing PinchTab

This is the release checklist for the GitHub tag-driven release pipeline.

One-time setup

• Create the public tap repository pinchtab/homebrew-tap.
• Add the HOMEBREW_TAP_GITHUB_TOKEN Actions secret to pinchtab/pinchtab.
• The token must have write access to pinchtab/homebrew-tap.

What the release workflow does

Pushing a tag like v0.7.0 triggers release.yml, which:

1. Builds release binaries and creates the GitHub release via GoReleaser.
2. Publishes the npm package.
3. Builds and publishes container images.
4. Generates a Homebrew formula PR against pinchtab/homebrew-tap.

Release steps

1. Verify the branch you want to release is merged to main.
2. Push the release tag:

git tag v0.7.0
git push origin v0.7.0

3. Watch the Release workflow in GitHub Actions.
4. Confirm GoReleaser opens a PR in pinchtab/homebrew-tap.
5. Merge that PR.

After the tap PR is merged, users can install with:

brew install pinchtab/tap/pinchtab

Notes

• The Homebrew formula is not published until the tap PR is merged.
• No extra automation is required in homebrew-tap unless you want auto-merge.
• The release workflow can also be run manually with workflow_dispatch and a tag input.