feat: integrate changesets for version management and releases

Author: valentin-marquez

.changeset/CONTRIBUTING.md

@@ -0,0 +1,86 @@
+# Using Changesets
+
+This project uses [Changesets](https://github.com/changesets/changesets) to manage versioning and changelogs.
+
+## For Contributors
+
+When you make a change that affects users (bug fix, new feature, breaking change), you need to add a changeset:
+
+```bash
+bun changeset
+```
+
+This will prompt you to:
+
+1. Select the type of change (major/minor/patch)
+2. Write a summary of the change
+
+The changeset will be included in your PR.
+
+## Change Types
+
+- **Major** (1.0.0 → 2.0.0): Breaking changes
+- **Minor** (1.0.0 → 1.1.0): New features (backwards compatible)
+- **Patch** (1.0.0 → 1.0.1): Bug fixes
+
+## For Maintainers
+
+### Release Process (Manual Trigger)
+
+1. **Accumulate changesets** from merged PRs
+
+2. **Trigger release workflow**:
+   - Go to GitHub Actions → "Release" workflow
+   - Click "Run workflow"
+   - The workflow will:
+     - Consume all changesets
+     - Update package.json version
+     - Update CHANGELOG.md
+     - Commit changes
+     - Build Windows binaries
+     - Create git tag
+     - Create GitHub release with artifacts
+
+That's it! One click release.
+
+### What happens behind the scenes:
+
+```bash
+bun changeset:version  # Consumes changesets, updates version
+git commit & push      # Commits version bump
+bun run build:win      # Builds binaries
+gh release create      # Creates GitHub release
+```
+
+## Examples
+
+### Adding a Changeset
+
+```bash
+$ bun changeset
+🦋  Which packages would you like to include? · vlc-rpc
+🦋  Which type of change is this for vlc-rpc? · patch
+🦋  Please enter a summary for this change (this will be in the changelogs).
+🦋    (submit empty line to open external editor)
+🦋  Summary · Fixed cover art upload issues
+🦋
+🦋  === Summary of changesets ===
+🦋  patch:  vlc-rpc
+🦋
+🦋  Is this your desired changeset? (Y/n) · true
+🦋  Changeset added! - you can now commit it
+```
+
+### Viewing Pending Changesets
+
+```bash
+bun changeset status
+```
+
+## Workflow
+
+```
+PR with changeset → Merge → Changesets accumulate → Manual trigger "Release" → Done
+```
+
+Simple and controlled!

.changeset/README.md

@@ -0,0 +1,8 @@
+# Changesets
+
+Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
+with multi-package repos, or single-package repos to help you version and publish your code. You can
+find the full documentation for it [in our repository](https://github.com/changesets/changesets)
+
+We have a quick list of common questions to get you started engaging with this project in
+[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)

.changeset/config.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.1.1/schema.json",
+  "changelog": "@changesets/cli/changelog",
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": [],
+  "___experimentalUnsafeOptions_WILL_CHANGE_IN_PATCH": {
+    "onlyUpdatePeerDependentsWhenOutOfRange": true
+  }
+}

.github/workflows/release-manual.yml

@@ -0,0 +1,73 @@
+name: Release
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    name: Build and Release
+    runs-on: windows-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Version packages with Changesets
+        run: |
+          bun changeset:version
+
+          $packageJson = Get-Content package.json | ConvertFrom-Json
+          $version = $packageJson.version
+          $tag = "v$version"
+
+          Write-Host "::notice::Version: $version"
+          Write-Host "::notice::Tag: $tag"
+
+          echo "VERSION=$version" >> $env:GITHUB_ENV
+          echo "TAG=$tag" >> $env:GITHUB_ENV
+        shell: pwsh
+
+      - name: Commit version changes
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          git add .
+          try {
+            git commit -m "chore: release v${{ env.VERSION }}"
+            git push
+          } catch {
+            Write-Host "No changes to commit"
+          }
+        shell: pwsh
+
+      - name: Build Windows binaries
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: bun run build:win
+
+      - name: Create git tag and release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          git tag "${{ env.TAG }}" -f
+          git push origin "${{ env.TAG }}" -f
+
+          gh release create "${{ env.TAG }}" `
+            --title "VLC Discord RP ${{ env.TAG }}" `
+            --notes "See [CHANGELOG.md](https://github.com/valentin-marquez/vlc-rpc/blob/main/CHANGELOG.md) for detailed changes." `
+            dist/*.exe `
+            dist/*.zip `
+            dist/*.yml `
+            dist/*.blockmap `
+            --latest
+        shell: pwsh

.github/workflows/release.yml

@@ -89,6 +89,20 @@ The app runs in your system tray. Right-click the tray icon to:
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
 
+## Contributing
+
+Contributions are welcome! To contribute:
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Make your changes
+4. Add a changeset: `bun changeset` (see [.changeset/CONTRIBUTING.md](.changeset/CONTRIBUTING.md))
+5. Commit your changes (`git commit -m 'Add amazing feature'`)
+6. Push to the branch (`git push origin feature/amazing-feature`)
+7. Open a Pull Request
+
+Please ensure your PR includes a changeset for any user-facing changes.
+
 ## Support
 
 Found a bug or have a feature request? [Open an issue](https://github.com/valentin-marquez/vlc-rpc/issues) on GitHub.