Releases are intentionally prepared in a pull request, rather than published from every feature branch.
- Add Rivet release files with
rivet newin feature branches. - Merge those changes into
main. - The
Releaseworkflow runsrivet bumpon therivet-releasebranch and creates or updates a version pull request. - Review and merge the version pull request, including versions, changelogs, and
.rivet/releaseplan.txt. - The next
mainpush runs the configured native build andrivet releasefor the committed versions.
- Add
NPM_TOKENas a repository secret. The workflow also needsGITHUB_TOKENpermissions forcontents: writeandpull-requests: write. - Configure the package version and changelog in the bump PR before promoting it.
The release workflow uses the local Rivet GitHub Action. It reads .rivet/releaseplan.txt, publishes the committed package versions, skips versions already present on npm, and removes the plan in the CI workspace after a successful release.