release: v0.1.0

Author: ddurzo

.github/workflows/release.yml

@@ -0,0 +1,102 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Existing tag to release (e.g. v0.2.0)"
+        required: true
+        type: string
+
+permissions:
+  contents: write
+
+jobs:
+  prepare-release:
+    runs-on: ubuntu-latest
+    outputs:
+      tag: ${{ steps.tag.outputs.tag }}
+    steps:
+      - name: Resolve tag
+        id: tag
+        run: |
+          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+            echo "tag=${{ github.event.inputs.tag }}" >> "$GITHUB_OUTPUT"
+          else
+            echo "tag=${GITHUB_REF_NAME}" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Create GitHub Release with auto notes
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ steps.tag.outputs.tag }}
+          generate_release_notes: true
+          draft: false
+          prerelease: ${{ contains(steps.tag.outputs.tag, '-') }}
+
+  build-and-upload:
+    needs: prepare-release
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            bundles: appimage,deb
+            files: |
+              src-tauri/target/release/bundle/appimage/*.AppImage
+              src-tauri/target/release/bundle/deb/*.deb
+          - os: windows-latest
+            bundles: msi,nsis
+            files: |
+              src-tauri/target/release/bundle/msi/*.msi
+              src-tauri/target/release/bundle/nsis/*.exe
+          - os: macos-latest
+            bundles: app,dmg
+            files: |
+              src-tauri/target/release/bundle/macos/*.app.tar.gz
+              src-tauri/target/release/bundle/dmg/*.dmg
+    runs-on: ${{ matrix.os }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ needs.prepare-release.outputs.tag }}
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Install Linux system dependencies (Tauri)
+        if: runner.os == 'Linux'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y \
+            build-essential \
+            pkg-config \
+            libgtk-3-dev \
+            libayatana-appindicator3-dev \
+            librsvg2-dev \
+            patchelf
+          sudo apt-get install -y libwebkit2gtk-4.1-dev || sudo apt-get install -y libwebkit2gtk-4.0-dev
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build bundles
+        run: npm run tauri -- build --bundles ${{ matrix.bundles }}
+
+      - name: Upload release assets
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ needs.prepare-release.outputs.tag }}
+          files: ${{ matrix.files }}
+          fail_on_unmatched_files: true

DEVELOPER_GUIDE.md

@@ -231,9 +231,19 @@ cargo check --manifest-path src-tauri/Cargo.toml
 ## 14. CI and Quality Gates
 
 - GitHub Actions workflow: `.github/workflows/ci.yml`
+- GitHub Actions release workflow: `.github/workflows/release.yml`
 - Unified test entrypoint: `scripts/test-all.sh`
 - Frontend coverage thresholds (Vitest):
   - lines >= 90
   - statements >= 90
   - functions >= 90
   - branches >= 80
+
+Release automation notes:
+
+- release trigger: tag push `v*` (for example `v0.2.0`)
+- release notes: generated automatically by GitHub
+- artifacts uploaded by matrix build:
+  - Linux: `.AppImage`, `.deb`
+  - Windows: `.msi`, `.exe` (NSIS)
+  - macOS: `.dmg`, `.app.tar.gz`

README.md

@@ -110,6 +110,40 @@ Coverage policy (enforced):
 - functions >= 90%
 - branches >= 80%
 
+## Automated Releases (GitHub)
+
+Release builds are automated through `.github/workflows/release.yml`.
+
+Trigger modes:
+
+- push a tag like `v0.2.0` (recommended)
+- manual run via `workflow_dispatch` with an existing tag
+
+What the workflow does:
+
+1. creates/updates a GitHub Release with auto-generated release notes
+2. builds platform bundles on Linux, Windows, and macOS
+3. uploads downloadable assets to the Release
+
+### Version + Tag Flow
+
+Prepare version files:
+
+```bash
+./scripts/release-tag.sh 0.2.0
+```
+
+Then create and push the tag:
+
+```bash
+git add package.json src-tauri/tauri.conf.json
+git commit -m "release: v0.2.0"
+git tag v0.2.0
+git push origin <your-branch> --tags
+```
+
+After tag push, GitHub Actions will publish the release artifacts automatically.
+
 ## Icon Pipeline
 
 Project icon source:

scripts/release-tag.sh

@@ -0,0 +1,41 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [ $# -ne 1 ]; then
+  echo "Usage: $0 <version>"
+  echo "Example: $0 0.2.0"
+  exit 1
+fi
+
+VERSION="$1"
+if [[ ! "$VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+([.-][0-9A-Za-z.-]+)?$ ]]; then
+  echo "Invalid version: $VERSION"
+  exit 1
+fi
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+cd "$ROOT_DIR"
+
+node -e '
+const fs = require("fs");
+const version = process.argv[1];
+const pkgPath = "package.json";
+const tauriPath = "src-tauri/tauri.conf.json";
+const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+pkg.version = version;
+fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
+const tauri = JSON.parse(fs.readFileSync(tauriPath, "utf8"));
+tauri.version = version;
+fs.writeFileSync(tauriPath, JSON.stringify(tauri, null, 2) + "\n");
+' "$VERSION"
+
+echo "Updated versions to $VERSION in:"
+echo "- package.json"
+echo "- src-tauri/tauri.conf.json"
+
+echo
+echo "Next steps:"
+echo "  git add package.json src-tauri/tauri.conf.json"
+echo "  git commit -m 'release: v$VERSION'"
+echo "  git tag v$VERSION"
+echo "  git push origin <branch> --tags"

src-tauri/tauri.conf.json

@@ -28,7 +28,9 @@
   },
   "bundle": {
     "active": true,
-    "targets": ["app"],
+    "targets": [
+      "app"
+    ],
     "icon": [
       "icons/32x32.png",
       "icons/128x128.png",