← gitpulse
Merged
Size
M
Change Breakdown
CI/CD50%
New Feature35%
Documentation15%
#9feat: one-click GitHub release workflow

One-click GitHub Releases now automated

Gitpulse maintainers can now produce a full GitHub Release — complete with auto-generated notes, version-bumped package.json files, and a moving major-version pointer — with one click from the Actions tab.

Releasing software is a multi-step ritual: bump versions, commit, tag, push, and create the GitHub Release with notes. Done by hand, it's error-prone and easy to forget a step. The .github/workflows/release.yml workflow automates the entire sequence.

Maintainers open the repo's Actions tab, select the Release workflow, enter a version like 1.0.0 or 1.1.0-rc.1, and click Run. The workflow validates the semver string and rejects any version with an existing tag. Tests and typechecks run first — red tests block the release. Then it updates all workspace package.json files in lockstep, commits the bump, creates an immutable v1.0.0 tag plus a moving major-version pointer (v1, v2, …), and publishes a real GitHub Release with auto-generated notes. Pre-release versions are flagged automatically.

A safeguard rejects dispatch from non-main refs, preventing accidental releases of code that hasn't landed on the default branch. The README documents the flow and notes that repos with branch protection may need to allow-list the github-actions[bot] user or swap in a personal access token.