Skip to content


Switch branches/tags

GitFlow release workflow using GitHub actions

This repository contains GitHub workflows that allow for fully automated release as per the GitFlow conventions. You are welcome to use it for inspiration for your own release workflows or maybe even copying them verbatim if the fit your needs.


If you are using the workflows as they are in this repository, there are only two manual steps for releasing a new version:

  1. Trigger the "Draft new release" workflow through the "Actions" tab.
  2. Merge the PR that is created for you.

The automation will do the following things:

  • Update your changelog with the new version
  • Change the version in the necessary manifest files
  • Tag the final release and create a GitHub release


I've written a blog post that describes the technical design in detail here:

NOTE: The workflows and actions in this repository were changed since the blogpost was published. Please see the for a detailed summary.

The idea of these workflows is to automate all the tedious aspects of releases while still allowing manual intervention if necessary and control over crucial aspects.

I think I've achieved this by doing the following:

  • The individual GitHub actions used are small and focused.

This allows you to adapt the workflows to your own needs. Ironically, this is what makes this whole repository not special. It just takes good ideas that are already out there and creates automation around them.

  • You have full control over what the next version is.

There is no magic involved, only the tedious things are automated. You have full control over what is being released and under which version.

Hall of fame

If you are using these workflow or got inspired by them to build something similar, feel free to add yourself to this list: