shared-workflows/README.md

# Shared Workflows

Reusable Gitea Actions workflows for Unbound Software repositories.

## Available Workflows

### Release.yml

Automated release workflow using [git-cliff](https://github.com/orhun/git-cliff) for changelog generation.

**Usage:**

```yaml
name: Release

on:
  push:
    branches: [main]

jobs:
  release:
    uses: unboundsoftware/shared-workflows/.gitea/workflows/Release.yml@main
```

**Inputs:**

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

**Requirements:**

This workflow reads the release token from `/runner-secrets/release-token`, which is automatically available on Unbound's Gitea runners. No repository secrets need to be configured.

**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 Gitea release with the changelog