dnd-it/action-releaser
Flexible GitHub Action for versioned releases powered by git-cliff
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit May 29, 2026
- License
- None
Pinned Snippet
uses: dnd-it/action-releaser@92d123c49ddda92f7fe83c0b6834017b66832a27 # v0.3.4tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| version-strategy | Versioning strategy: semver or calver | no | semver |
| cliff-config | Path to custom cliff.toml | no | "" |
| tag-prefix | Prefix for git tags (e.g. v, release-). Defaults to empty string. | no | "" |
| release-mode | Release mode: direct (immediate release) or pr (create release PR, release on merge) | no | direct |
| draft | Create release as draft | no | false |
| prerelease | Mark release as prerelease | no | false |
| include-path | Glob pattern to scope commits by file path (e.g. "services/api/**"). Used in monorepos to ensure only commits touching this path affect version calculation and changelog. | no | "" |
| dry-run | Calculate version and changelog but do not create a tag or release | no | false |
| github-token | GitHub token for release creation. Needs contents:write scope. | no | ${{ github.token }} |
Outputs
| name | description |
|---|---|
| version | Calculated version string (empty if skipped) |
| changelog | Generated changelog text (empty if skipped) |
| tag | Created git tag (empty if skipped or dry-run) |
| release-url | URL of the published GitHub Release. Only set when a release is actually created (direct mode, or gated mode after PR merge). Empty in pr mode before the PR is merged. |
| previous-version | Previous version tag (empty on first release) |
| skipped | true if no release was created, false otherwise |
| pr-url | Release PR URL (only in pr mode, same as release-pr-url) |
| dry-run | true if dry-run mode was active |
| release-published | true when a GitHub Release was actually created (direct mode or after gated PR merge) |
| release-pr-url | URL of the open release PR (only set in pr mode while the PR is pending merge) |
| release-pr-number | Number of the open release PR (only set in pr mode while the PR is pending merge) |
| release-mode | Active release mode: "direct" or "pr". Echoes the release-mode input so downstream jobs can branch without re-reading inputs. |
| pr-created | true when a new release PR was opened in this run; false when an existing PR was updated. Only meaningful in pr mode. |