RELEASE.md

Release Guide

Steps to Release a New Version

1. Update CHANGELOG.md:

   • Add version entry: ## [X.Y.Z] - YYYY-MM-DD with changes

2. Update version in package.json, manifest.json, and manifest-firefox.json:

   # Edit all three files to set "version": "X.Y.Z"

   Then run npm install to sync package-lock.json:

   npm install

3. Verify build locally:

   npm run build

   Confirm the zip files are generated in dist/ without errors. You may keep them for manual testing.

4. Commit changes:

   git add CHANGELOG.md package.json manifest.json manifest-firefox.json
   git commit -m "chore: update version to vX.Y.Z"
   git push origin main

5. Run the release workflow:

   gh workflow run release.yml

   This will run tests, build Chrome & Firefox packages, and create a GitHub Release with the zip files.

   To overwrite an existing release for the same version:

   gh workflow run release.yml -f overwrite=true

6. Verify the release was created successfully:

   gh release view vX.Y.Z

7. Update the release notes on GitHub to match CHANGELOG.md:

   Write the notes in Markdown format to a temp file, then pass it via --notes-file:

   gh release edit vX.Y.Z --notes-file /path/to/notes.md

   Notes format:

   ## What's Changed
   
   ### Added/Changed/Fixed
   
   - Change 1
   - Change 2
   
   **Full Changelog**: https://github.com/euxx/github-notifier-pro/compare/vPREV...vX.Y.Z