jlopez/Derive Semantic Version

Repo-wide semantic version from git tags + conventional commits; no version stored in-tree. Optionally tags + releases.

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Stale
License
None
namedescriptionrequireddefault
initial-versionBaseline seeded as the first release when no tag exists yet.0.1.0
tag-prefixPrefix identifying this scheme's tags (e.g. `v` → `v1.2.3`).v
create-releaseWhen 'true' and a release is warranted, push the tag and create a GitHub Release. When 'false' (default), only compute outputs (dry run). false
floating-tagsWhen 'true', also maintain floating `vMAJOR` / `vMAJOR.MINOR` tags that advance to each release (so consumers can pin `@v1` for the latest `1.x`). For repos distributing a GitHub Action; leave 'false' (default) otherwise. Pushes only happen alongside `create-release`, so PR dry-runs move nothing. false
github-tokenToken used to create the Release (needs `contents: write`).${{ github.token }}
namedescription
versionThe computed version, no prefix (e.g. `1.2.3`).
tagThe computed tag, with prefix (e.g. `v1.2.3`).
previous-tagThe tag this was derived from, or '' on the first run.
bumpmajor | minor | patch | none.
released'true' when a release is warranted (a tag/Release should exist).
via-release-as'true' when a `Release-As:` footer forced the version.
build-identityAlways-available `git describe` identity (e.g. `v1.2.3-3-gabc1234`).