Summary
Replace the manual version bump + tag workflow with release-please for fully automated versioning.
Current flow (manual)
- Bump
version in package.json
- Update
CHANGELOG.md
- Commit, tag, push
- Pipeline publishes
Target flow (release-please)
- Merge PRs with conventional commits
- release-please automatically maintains a "Release PR" that bumps version + CHANGELOG
- Merge the Release PR → tag is created → pipeline publishes to npm + creates GitHub Release
Why
- Zero manual version management
- CHANGELOG is always up to date
- Fits the existing conventional commit convention
- Used by Firebase, Angular, Google Cloud, and many npm packages
Implementation
- Add
.github/workflows/release-please.yml
- Configure for Node.js / npm package type
- Update CONTRIBUTING.md releasing section
- Existing
release.yml workflow continues to handle npm publish on tag push (release-please creates the tags)
Priority
Low — current manual flow works fine for now. Adopt when release frequency increases.
Summary
Replace the manual version bump + tag workflow with release-please for fully automated versioning.
Current flow (manual)
versioninpackage.jsonCHANGELOG.mdTarget flow (release-please)
Why
Implementation
.github/workflows/release-please.ymlrelease.ymlworkflow continues to handle npm publish on tag push (release-please creates the tags)Priority
Low — current manual flow works fine for now. Adopt when release frequency increases.