trigger releases from CHANGELOG.md

- add Keep a Changelog format CHANGELOG.md
- CI now triggers on CHANGELOG.md changes to master
- parses latest version and release notes from CHANGELOG
- skips if tag already exists
- rename default branch from `master` to `main`

Co-Authored-By: Claude Opus 4.6 <[email protected]>

Author: hall

.github/workflows/main.yaml

@@ -1,22 +1,51 @@
 name: Release
 on:
   push:
-    tags:
-      - "*"
+    branches:
+      - main
+    paths:
+      - CHANGELOG.md
 jobs:
   release:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
         uses: actions/checkout@v4
 
+      - name: Get version from CHANGELOG
+        id: version
+        run: |
+          VERSION=$(grep -m1 -oP '## \[\K[^\]]+' CHANGELOG.md)
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+
+          # extract release notes between first and second ## heading
+          BODY=$(awk '/^## \[/{if(n++)exit}n' CHANGELOG.md)
+          {
+            echo "body<<RELEASE_EOF"
+            echo "$BODY"
+            echo "RELEASE_EOF"
+          } >> "$GITHUB_OUTPUT"
+
+      - name: Check if tag exists
+        id: check
+        run: |
+          if git rev-parse "${{ steps.version.outputs.version }}" >/dev/null 2>&1; then
+            echo "exists=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "exists=false" >> "$GITHUB_OUTPUT"
+          fi
+
       - name: Install Nix
+        if: steps.check.outputs.exists == 'false'
         uses: cachix/install-nix-action@v31
 
       - name: Build
+        if: steps.check.outputs.exists == 'false'
+        env:
+          VERSION: ${{ steps.version.outputs.version }}
         run: |
           nix develop --command bash -c '
-            sed -i "s|{/\* VERSION \*/}.*|${GITHUB_REF##*/}|g" src/index.jsx
+            sed -i "s|{/\* VERSION \*/}.*|${VERSION}|g" src/index.jsx
 
             npm ci
             npm run build
@@ -27,7 +56,9 @@ jobs:
           '
 
       - name: Release
+        if: steps.check.outputs.exists == 'false'
         uses: softprops/action-gh-release@v2
-        if: startsWith(github.ref, 'refs/tags/')
         with:
+          tag_name: ${{ steps.version.outputs.version }}
+          body: ${{ steps.version.outputs.body }}
           files: "*.zip"

CHANGELOG.md

@@ -0,0 +1,39 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/),
+and this project adheres to [Semantic Versioning](https://semver.org/).
+
+## [0.5.0]
+
+### Changed
+
+- Migrate from preact-cli to vite
+- Replace react-modal, axios, and lodash with native APIs
+- Convert class components to functional components
+- Use nix in CI workflow
+
+## [0.4.0]
+
+### Removed
+
+- Unused lighttpd configuration
+
+## [0.3.2]
+
+### Changed
+
+- Use nord theme for softer color palette
+
+## [0.3.1]
+
+### Changed
+
+- Simplify and cleanup table layout
+
+## [0.3.0]
+
+### Changed
+
+- Grey-out rows of ports which aren't established

CONTRIBUTING.md

@@ -21,4 +21,4 @@ Then navigate to http://localhost:8080.
 
 ## Releasing
 
-A GitHub action (defined in [`.github/workflows/main.yaml`](./.github/workflows/main.yaml)) will run whenever a new tag is pushed and create a release.
+[A GitHub action](./.github/workflows/main.yaml)) will create a new release whenever a new version is specified in [`CHANGELOG.md`](./CHANGELOG.md).