sjquant/flopha

Auto-tag the next version and optionally create a GitHub Release. Bump level is detected from commit messages via regex — conventional commits by default, fully customisable. Requires permissions: contents: write.

Trust Signals

Scorecard Score: not yet scored
Maintenance Recency: Stale
License: None

Inputs

name	description	required	default
auto	Detect bump level from conventional commits: feat→minor, feat!/BREAKING CHANGE→major, anything else→patch.	no	true
increment	Bump level when auto is false: major, minor, or patch.	no	patch
pattern	Tag pattern, e.g. 'v{major}.{minor}.{patch}' or 'app@{semver}'.	no	v{major}.{minor}.{patch}
pre	Pre-release channel: alpha, beta, rc, etc. Marks the release as a pre-release.	no	""
rule	Custom bump rules, one per line, as 'level:regex'. When provided, replaces major-pattern, minor-pattern, and the built-in defaults entirely. Example: "major:BREAKING CHANGE\nminor:^feat"	no	""
changelog	Generate a changelog from commits since the previous tag. The result is always available as the `changelog` output regardless of other settings. When `create-release` is true and `release-body` is not set, the changelog is also used as the GitHub Release body.	no	false
changelog-groups	Custom changelog group rules, one per line, as 'TITLE:REGEX'. When provided, replaces the built-in conventional-commit defaults entirely. Example: "Breaking Changes:BREAKING CHANGE\nFeatures:^feat"	no	""
changelog-other	Title for commits that match no group. Default: "Other Changes".	no	""
changelog-suppress-other	Set to true to omit commits that match no group entirely.	no	false
create-release	Create a GitHub Release for the new tag.	no	false
draft	Create the GitHub Release as a draft (requires create-release: true).	no	false
release-title	Title for the GitHub Release. Defaults to the tag name.	no	""
release-body	Body text for the GitHub Release. When set, takes precedence over generate-release-notes.	no	""
generate-release-notes	Auto-generate release notes from commits using the GitHub API.	no	false
dry-run	Compute and print the next tag without creating or pushing anything.	no	false
flopha-version	flopha binary version to install, e.g. 'v0.2.0'. Defaults to latest.	no	latest
github-token	Token used to push the tag and create the GitHub Release.	no	${{ github.token }}

Outputs

name	description
tag	The version tag that was created and pushed (or would be, on dry-run).
version	The bare version number, e.g. 1.2.3 (tag without leading v or other prefix).
release-url	URL of the GitHub Release. Empty when create-release is false or dry-run is true.
changelog	Generated changelog text (Markdown by default). Empty when changelog input is false.