release: v2.3.1 — dynamic website changelog, auto release notes

- Website changelog now fetches from GitHub Releases API
- CI auto-generates release notes from git log
- Pages deploys on tag push
- No more manual website updates for releases

Author: noahalorwu

.github/workflows/build.yml

@@ -131,28 +131,42 @@ jobs:
         id: version
         run: echo "version=$(grep 'MARKETING_VERSION' project.yml | head -1 | awk '{print $2}' | tr -d '\"')" >> $GITHUB_OUTPUT
 
+      - name: Generate release notes
+        id: notes
+        run: |
+          # Get commits since last tag
+          PREV_TAG=$(git describe --tags --abbrev=0 HEAD^ 2>/dev/null || echo "")
+          if [ -n "$PREV_TAG" ]; then
+            CHANGES=$(git log "$PREV_TAG"..HEAD --pretty=format:"- %s" --no-merges | grep -v "^- chore:" | grep -v "^- Merge" | head -20)
+          else
+            CHANGES="- Initial release"
+          fi
+
+          # Write to file for multiline support
+          cat > build/release-notes.md << 'HEADER'
+          ## DX Tools v${{ steps.version.outputs.version }}
+
+          ### Downloads
+          - **DXTools.dmg** — macOS app (drag to Applications)
+          - **dx** — CLI binary (copy to `~/bin/` or `/usr/local/bin/`)
+
+          ### Install via Homebrew
+          ```
+          brew tap openstruct/tap && brew install dx-tools
+          ```
+
+          ### Changes
+          HEADER
+
+          echo "$CHANGES" >> build/release-notes.md
+
       - name: Create GitHub Release
         uses: softprops/action-gh-release@v2
         with:
           tag_name: v${{ steps.version.outputs.version }}
           name: DX Tools v${{ steps.version.outputs.version }}
           make_latest: true
-          body: |
-            ## DX Tools v${{ steps.version.outputs.version }}
-
-            ### Downloads
-            - **DXTools.dmg** — macOS app (drag to Applications)
-            - **dx** — CLI binary (copy to `~/bin/` or `/usr/local/bin/`)
-
-            ### Install via Homebrew
-            ```
-            brew tap openstruct/tap && brew install dx-tools
-            ```
-
-            ### What's Included
-            - 33 developer tools in one native macOS app
-            - CLI with 10 subcommands: json, jwt, epoch, env, hash, base64, uuid, color, pass, port
-            - 300 tests, zero dependencies, ~3 MB
+          body_path: build/release-notes.md
           files: |
             build/DXTools.dmg
             .build/release/dx

.github/workflows/pages.yml

@@ -4,6 +4,7 @@ on:
   push:
     branches: [main]
     paths: ['web/**']
+    tags: ['v*']
   workflow_dispatch:
 
 permissions:

project.yml

@@ -10,7 +10,7 @@ settings:
   base:
     SWIFT_VERSION: "5.9"
     MACOSX_DEPLOYMENT_TARGET: "14.0"
-    MARKETING_VERSION: "2.3.0"
+    MARKETING_VERSION: "2.3.1"
     CURRENT_PROJECT_VERSION: 1
 
 targets:

web/index.html

@@ -393,71 +393,8 @@ <h3>Pro Code Editor</h3>
   <h2 class="section-title">What's New</h2>
   <p class="section-sub">Every release, every fix, every improvement.</p>
 
-  <div class="changelog-timeline">
-    <div class="cl-entry latest">
-      <div class="cl-version">
-        <span class="v">v2.2.0</span>
-        <span class="badge-new">Latest</span>
-        <span class="date">March 15, 2026</span>
-      </div>
-      <ul class="cl-list">
-        <li><span class="cl-icon cl-fix">●</span> API Request Builder — params now correctly applied to requests</li>
-        <li><span class="cl-icon cl-improve">◆</span> Port Manager — redesigned kill buttons with outline style, hover reveal</li>
-        <li><span class="cl-icon cl-improve">◆</span> QR Code — shorter correction level picker (L/M/Q/H segments)</li>
-        <li><span class="cl-icon cl-improve">◆</span> All 33 tools use single clean ToolHeader — no more double headers</li>
-        <li><span class="cl-icon cl-fix">●</span> 300 tests, 0 failures across 25 test suites</li>
-      </ul>
-    </div>
-
-    <div class="cl-entry">
-      <div class="cl-version">
-        <span class="v">v2.1.0</span>
-        <span class="date">March 15, 2026</span>
-      </div>
-      <ul class="cl-list">
-        <li><span class="cl-icon cl-new">✦</span> QR Code Generator — 4 error correction levels, copy/save PNG</li>
-        <li><span class="cl-icon cl-new">✦</span> Image Base64 — encode images to base64/data URI, decode back</li>
-        <li><span class="cl-icon cl-new">✦</span> SQL Formatter — format & minify SQL, 3 indent styles</li>
-        <li><span class="cl-icon cl-new">✦</span> JSON Schema Validator — type, required, min/max, pattern, arrays</li>
-        <li><span class="cl-icon cl-new">✦</span> HTTP Status Codes — searchable reference, color-coded categories</li>
-        <li><span class="cl-icon cl-new">✦</span> Input syntax highlighting — live JSON/SQL coloring in editor</li>
-        <li><span class="cl-icon cl-new">✦</span> History panel — browse & restore past inputs per tool</li>
-        <li><span class="cl-icon cl-new">✦</span> URL handler — <code>dx://tool-name</code> opens app to specific tool</li>
-        <li><span class="cl-icon cl-new">✦</span> Auto-update checker — checks GitHub Releases on launch</li>
-        <li><span class="cl-icon cl-improve">◆</span> Custom app icon — orange "DX" monogram on dark background</li>
-        <li><span class="cl-icon cl-improve">◆</span> Settings view with font size, indent style, theme toggle</li>
-        <li><span class="cl-icon cl-improve">◆</span> Onboarding — 3-screen first-launch walkthrough</li>
-        <li><span class="cl-icon cl-improve">◆</span> Command Palette — ⌘K overlay with fuzzy search</li>
-      </ul>
-    </div>
-
-    <div class="cl-entry">
-      <div class="cl-version">
-        <span class="v">v2.0.0</span>
-        <span class="date">March 15, 2026</span>
-      </div>
-      <ul class="cl-list">
-        <li><span class="cl-icon cl-new">✦</span> 23 developer tools in one native macOS app</li>
-        <li><span class="cl-icon cl-new">✦</span> Port Manager, Network Info, URL Encoder, Unix Permissions, Cron Parser</li>
-        <li><span class="cl-icon cl-new">✦</span> SSH Key Generator, Docker Manager, Git Stats, Timestamp Converter, Text Diff</li>
-        <li><span class="cl-icon cl-new">✦</span> API Request Builder, smart clipboard, menu bar, CLI companion</li>
-        <li><span class="cl-icon cl-improve">◆</span> Pro code editor, dark/light theme, favorites system</li>
-      </ul>
-    </div>
-
-    <div class="cl-entry">
-      <div class="cl-version">
-        <span class="v">v1.0.0</span>
-        <span class="date">Initial Release</span>
-      </div>
-      <ul class="cl-list">
-        <li><span class="cl-icon cl-new">✦</span> JSON Formatter, JSON → Go/Swift/TypeScript, JSON Diff</li>
-        <li><span class="cl-icon cl-new">✦</span> JWT Decoder, Base64, Hash Generator</li>
-        <li><span class="cl-icon cl-new">✦</span> UUID Generator, Color Converter, Epoch Converter</li>
-        <li><span class="cl-icon cl-new">✦</span> Password Generator, Env Manager</li>
-        <li><span class="cl-icon cl-new">✦</span> cURL → Code, Regex Tester, Markdown Preview, Lorem Generator</li>
-      </ul>
-    </div>
+  <div class="changelog-timeline" id="changelog-timeline">
+    <div class="cl-entry"><div class="cl-version"><span class="v" style="color:var(--text3)">Loading releases…</span></div></div>
   </div>
 </section>
 
@@ -568,29 +505,88 @@ <h2 class="section-title">Keyboard-First</h2>
   setTimeout(() => toast.classList.remove('show'), 2000);
 }
 
-// Fetch latest release info from GitHub API
-async function fetchRelease() {
+// Classify a changelog line as new/improve/fix
+function classifyLine(line) {
+  const l = line.toLowerCase();
+  if (l.startsWith('- feat') || l.includes('new tool') || l.includes('added') || l.match(/^- \*\*\w.*\*\* —.*new/))
+    return 'new';
+  if (l.startsWith('- fix') || l.includes('bug') || l.includes('fixed') || l.includes('hotfix'))
+    return 'fix';
+  return 'improve';
+}
+
+function lineIcon(type) {
+  if (type === 'new') return '<span class="cl-icon cl-new">✦</span>';
+  if (type === 'fix') return '<span class="cl-icon cl-fix">●</span>';
+  return '<span class="cl-icon cl-improve">◆</span>';
+}
+
+// Parse release body into clean bullet points
+function parseBody(body) {
+  if (!body) return [];
+  return body.split('\n')
+    .map(l => l.trim())
+    .filter(l => l.startsWith('- ') || l.startsWith('* '))
+    .map(l => l.replace(/^[-*]\s+/, '').replace(/\*\*/g, ''))
+    .filter(l => l.length > 0 && !l.startsWith('#') && !l.startsWith('```'));
+}
+
+// Format date
+function fmtDate(dateStr) {
+  const d = new Date(dateStr);
+  return d.toLocaleDateString('en-US', { month: 'long', day: 'numeric', year: 'numeric' });
+}
+
+// Fetch all releases and render changelog + hero
+async function fetchReleases() {
   try {
-    const res = await fetch('https://api.github.com/repos/OpenStruct/dx-tools/releases/latest');
+    const res = await fetch('https://api.github.com/repos/OpenStruct/dx-tools/releases?per_page=20');
     if (!res.ok) return;
-    const data = await res.json();
+    const releases = await res.json();
+    if (!releases.length) return;
 
-    // Update version badge
+    // Update hero version
+    const latest = releases[0];
     const ver = document.getElementById('hero-version');
-    if (ver && data.tag_name) ver.textContent = data.tag_name;
+    if (ver) ver.textContent = latest.tag_name;
 
-    // Update download link to DMG asset
-    const dmg = data.assets?.find(a => a.name.endsWith('.dmg'));
+    // Update download button
+    const dmg = latest.assets?.find(a => a.name.endsWith('.dmg'));
     if (dmg) {
       const btn = document.getElementById('dl-btn-main');
       if (btn) btn.href = dmg.browser_download_url;
-
       const size = document.getElementById('dl-size');
       if (size) size.textContent = (dmg.size / 1024 / 1024).toFixed(1) + ' MB';
     }
-  } catch (e) { /* silently fail, defaults work */ }
+
+    // Render changelog
+    const timeline = document.getElementById('changelog-timeline');
+    if (!timeline) return;
+
+    timeline.innerHTML = releases.map((rel, i) => {
+      const isLatest = i === 0;
+      const lines = parseBody(rel.body);
+      const bullets = lines.length > 0
+        ? lines.map(l => {
+            const type = classifyLine('- ' + l);
+            return `<li>${lineIcon(type)} ${l}</li>`;
+          }).join('')
+        : `<li>${lineIcon('new')} ${rel.name || rel.tag_name}</li>`;
+
+      return `
+        <div class="cl-entry${isLatest ? ' latest' : ''}">
+          <div class="cl-version">
+            <span class="v">${rel.tag_name}</span>
+            ${isLatest ? '<span class="badge-new">Latest</span>' : ''}
+            <span class="date">${fmtDate(rel.published_at || rel.created_at)}</span>
+          </div>
+          <ul class="cl-list">${bullets}</ul>
+        </div>`;
+    }).join('');
+
+  } catch (e) { /* silently fail */ }
 }
-fetchRelease();
+fetchReleases();
 </script>
 </body>
 </html>