shared-workflows/README.md

Shared Workflows

Reusable Gitea Actions workflows for Unbound Software repositories.

Available Workflows

Release.yml

Automated release workflow using git-cliff for changelog generation.

Usage:

name: Release

on:
  push:
    branches: [main]

jobs:
  release:
    uses: unboundsoftware/shared-workflows/.gitea/workflows/Release.yml@main
    secrets:
      UNBOUND_RELEASE_TOKEN: ${{ secrets.GIT_API_TOKEN }}

Inputs:

• tag_only (boolean, default: false): Set to true to only create tags without full releases

Secrets:

• UNBOUND_RELEASE_TOKEN (required): Token with API access to create PRs and releases. Required scopes: repository (read/write), issue (read/write)

How it works:

1. On each push to the default branch, generates a changelog using git-cliff
2. Creates or updates a next-release branch with the updated CHANGELOG.md and .version file
3. Opens or updates a PR titled "chore(release): prepare for vX.Y.Z"
4. When the .version file exists (after merging the release PR), creates a GitHub release with the changelog