feat(footer): site version label; deploy Node 24; changeset

Author: graffhyrum

.changeset/footer-site-version.md

@@ -0,0 +1,5 @@
+---
+'pendragon-coding': patch
+---
+
+Show package version in site footer after Links for live deploy verification.

.github/workflows/deploy.yml

@@ -15,7 +15,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@v4
         with:
-          node-version: '22.12'
+          node-version: '24'
 
       - name: Setup Bun
         uses: oven-sh/setup-bun@v2

docs/deployment-guide.md

@@ -43,13 +43,13 @@ flowchart TD
 
 ### deploy.yml
 
-| Field       | Value                                                                                               |
-| ----------- | --------------------------------------------------------------------------------------------------- |
-| **Trigger** | Git tags matching `v*`                                                                              |
-| **Runner**  | Ubuntu latest                                                                                       |
-| **Steps**   | Checkout -> Setup Node 22.12+ -> Setup Bun -> `bun install` -> `bun run build` -> Deploy to Netlify |
-| **Action**  | `nwtgck/actions-netlify@v3.0`                                                                       |
-| **Secrets** | `NETLIFY_AUTH_TOKEN`, `NETLIFY_SITE_ID`, `GITHUB_TOKEN`                                             |
+| Field       | Value                                                                                           |
+| ----------- | ----------------------------------------------------------------------------------------------- |
+| **Trigger** | Git tags matching `v*`                                                                          |
+| **Runner**  | Ubuntu latest                                                                                   |
+| **Steps**   | Checkout -> Setup Node 24 -> Setup Bun -> `bun install` -> `bun run build` -> Deploy to Netlify |
+| **Action**  | `nwtgck/actions-netlify@v3.0`                                                                   |
+| **Secrets** | `NETLIFY_AUTH_TOKEN`, `NETLIFY_SITE_ID`, `GITHUB_TOKEN`                                         |
 
 ### release.yml
 
@@ -95,7 +95,7 @@ If either check fails, the build aborts and the deploy does not proceed.
 
 **Netlify logs** for this repo: Git builds are skipped by `ignore = "exit 0"`, so you will see “Canceled build due to no content change” / ignore exit 0 — that is **not** the same failure as the Actions log above. Production depends on `deploy.yml` succeeding after the tag push.
 
-**Fix:** `deploy.yml` runs `actions/setup-node` with Node **≥22.12** before `bun install` / `bun run build` so `node` on `PATH` satisfies Astro’s CLI. Bun remains the package manager and script runner.
+**Fix:** `deploy.yml` runs `actions/setup-node` with Node **24** (matches Netlify UI; satisfies Astro’s `>=22.12`) before `bun install` / `bun run build` so `node` on `PATH` satisfies Astro’s CLI. Bun remains the package manager and script runner.
 
 ## Manual Deployment
 

src/components/Footer.astro

@@ -1,4 +1,7 @@
 ---
+import pkg from '../../package.json';
+
+const appVersion = pkg.version;
 const links = [
 	{
 		name: 'LinkedIn',
@@ -29,4 +32,6 @@ const links = [
 			{name}
 		</a>
 	))}
+	<span class="text-sm tabular-nums text-green-800/90 dark:text-green-200/80" data-site-version
+		aria-label={`Site version ${appVersion}`}>v{appVersion}</span>
 </footer>

src/integration/footer-version.test.ts

@@ -0,0 +1,45 @@
+import { expect, test } from 'bun:test';
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+const root = join(import.meta.dir, '..', '..');
+
+function readPackageVersion(): string {
+	try {
+		const raw = readFileSync(join(root, 'package.json'), 'utf8');
+		const pkg = JSON.parse(raw) as { version?: string };
+		if (typeof pkg.version !== 'string' || !pkg.version) {
+			throw new Error('package.json missing version');
+		}
+		return pkg.version;
+	} catch (e) {
+		throw new Error('failed to read package.json', { cause: e });
+	}
+}
+
+test('Footer embeds site version from package.json', () => {
+	const version = readPackageVersion();
+	const footer = readFileSync(
+		join(root, 'src/components/Footer.astro'),
+		'utf8',
+	);
+	expect(version).toMatch(/^\d+\.\d+\.\d+/);
+	expect(footer).toContain("from '../../package.json'");
+	expect(footer).toContain('{appVersion}');
+	expect(footer.indexOf('Links:')).toBeLessThan(
+		footer.indexOf('data-site-version'),
+	);
+});
+
+test('built home page includes version in footer when dist exists', () => {
+	const distIndex = join(root, 'dist', 'index.html');
+	let html: string;
+	try {
+		html = readFileSync(distIndex, 'utf8');
+	} catch {
+		return;
+	}
+	const version = readPackageVersion();
+	expect(html).toContain(`v${version}`);
+	expect(html).toContain('data-site-version');
+});