Cut a release with downloadable assets by creating a git tag starting with v and pushing it to GitHub.

I recommend a workflow of bumping the VERSION file and then pushing that as a release, like so:

# edit the VERSION file first
git commit -m "Releasing v0.0.2"
git tag v0.0.2
git push --tags

You must push a tag along with an actual commit for the tag to actually push.

If you see a 403 error, you’ll need to adjust the repository permissions. Go to Settings > Acitions > General > Workflow Permissions and choose Read and Write.

Releases are set to prerelease! On public repositories, that means uploaded release assets are visible to other users, but are not listed as the latest release until you “publish” in the GitHub UI. You can change this default in the workflow yaml.

I would like the release process to be easier. I’m open to suggestions, please read the options and provide feedback.


Leave a Reply

Your email address will not be published. Required fields are marked *