Maintainers choose the release version in a pull request. Commit messages do not trigger automatic version bumps or npm releases.
- Create a branch from
master. - Update
package.jsonwithnpm version patch --no-git-tag-version, or choose the required minor, major, or explicit version. - Add the release notes to
CHANGELOG.mdand open a PR intomaster. - Merge the PR after its CI checks pass.
The Release workflow compares the package versions before and after the push
to master and publishes when the version changes. Dependency-only changes do
not publish a package. The workflow does not check whether the push came from a
PR; branch protection can enforce that repository policy.
The workflow checks out the exact pushed commit and installs dependencies.
npm publish runs the prepublishOnly script to build the package. The release
workflow relies on the PR's CI checks and does not run them again. It publishes
stable versions with the latest npm tag and prerelease versions with next.
It then creates a v<version> tag and a GitHub release with generated notes.
Release jobs run one at a time, with up to 100 pending jobs queued.
Stable releases use npm's default latest tag without an explicit --tag option.
If a newer stable version is already published, npm rejects an older unpublished
version instead of moving latest backward. This also applies when retrying an
older release job.
If a release fails, rerun its failed jobs in GitHub Actions. The workflow skips versions that already exist on npm and GitHub releases that already exist, so a retry can finish creating the GitHub release without publishing the package again.
Configure the utility package's trusted publisher on npm with:
- Organization:
node-modules - Repository:
utility - Workflow filename:
release.yml - Environment: leave empty
- Allowed action:
npm publish
The workflow uses Node.js 24, npm 11, and id-token: write for OIDC authentication.
It does not use an npm token or the GIT_TOKEN secret. GitHub release creation
uses the repository's built-in GITHUB_TOKEN.
See the npm trusted publishing documentation for the package settings.