Git Releases Widget
Shows recent releases from one or more repositories across multiple Git hosting platforms.
Supported platforms
| Platform | Notes |
|---|---|
| GitHub | Public repos free; private repos require a personal access token |
| GitLab | gitlab.com or self-hosted; private repos require a token |
| Codeberg | Public repos free; private repos require a token |
| Gitea | Self-hosted; requires an instance URL |
Configuration
Each repository is configured individually. The widget stores an array of repo entries under repos.
| Key | Type | Default | Description |
|---|---|---|---|
platform | string | github | Platform: github, gitlab, codeberg, or gitea |
repo | string | — | Repository path in owner/repo format |
accessToken | string | — | Personal access token (optional, required for private repos) |
instanceUrl | string | — | Base URL for self-hosted GitLab or Gitea instances |
Getting an access token
GitHub
- Go to Settings → Developer settings → Personal access tokens → Tokens (classic)
- Generate a new token with the
reposcope (orpublic_repofor public repos only)
GitLab
- Go to Profile → Access Tokens
- Create a token with the
read_apiscope
Codeberg / Gitea
- Go to Settings → Applications → Access Tokens
- Create a token with Repository read permissions
Notes
- Up to 10 releases are shown per repository
- Release data refreshes every 10 minutes
- Each repository section can be collapsed individually by clicking its header
- Releases are linked directly to the platform's release page