github-release

GitHub Release

Create GitHub release with formatted notes from commits since last tag.

Prereqs: gh authenticated, existing tags in repo

Workflow

1. Get commits since latest tag (run as separate commands):

   # First: get latest tag
   git tag --sort=-v:refname | head -1
   

   # Then: get commits since that tag (replace <TAG> with result above)
   git log <TAG>..HEAD --pretty=format:"%h %s%n%b---" --no-merges
   

2. Bump version if needed:

   • Check if version in decentpaste-app/src-tauri/tauri.conf.json matches latest tag
   • If yes, run /bump-version skill first
   • If already bumped, continue

3. Categorize by conventional commit prefix:

   Prefix	Section
   feat:	Features & Improvements
   fix:	Bug Fixes
   chore:, docs:, refactor:, perf:, style:, test:	Under the Hood

4. Generate notes (omit empty sections):

   ## What's New in vX.X.X
   
   [1-2 sentence summary]
   
   ### Features & Improvements
   - **Feature** - Description
   
   ### Bug Fixes
   - **Fix** - Description
   
   ### Under the Hood
   - **Change** - Description
   
   ### Downloads
   
   | Platform | Download |
   |----------|----------|
   | Windows | `DecentPaste_X.X.X_x64-setup.exe` |
   | macOS (Intel) | `DecentPaste_X.X.X_x64.dmg` |
   | macOS (Apple Silicon) | `DecentPaste_X.X.X_aarch64.dmg` |
   | Linux (Debian/Ubuntu) | `DecentPaste_X.X.X_amd64.deb` |
   | Linux (AppImage) | `DecentPaste_X.X.X_amd64.AppImage` |
   | Android | `DecentPaste_X.X.X.apk` |
   
   ---
   **Full Changelog**: https://github.com/decentpaste/decentpaste/compare/<prev-tag>...v<version>
   

5. Confirm with user: show version, tag, commit count, notes preview

6. Commit and push version bump (CRITICAL - must happen before creating release!):

   git add -A && git commit -m "chore: bump version to X.X.X"
   git push
   

   ⚠️ CI/CD builds from the pushed code. If you create the release before pushing, CI will build the old version!

7. Create release:

   gh release create vX.X.X --title "DecentPaste vX.X.X" --notes "$(cat <<'EOF'
   <notes>
   EOF
   )"
   

8. Done: Show release URL, CI will automatically build and upload artifacts