feat: add auto-generated last-updated dates to all pages

Author: s-adamantine

components/Layout.js

@@ -5,6 +5,7 @@ import { useRouter } from 'next/router';
 import { Sidebar } from './Sidebar';
 import { TableOfContents } from './TableOfContents';
 import { getPrevNext } from '../lib/navigation';
+import lastUpdated from '../lib/lastUpdated.json';
 import { Breadcrumbs } from './Breadcrumbs';
 import { ThemeToggle } from './ThemeToggle';
 import { SearchDialog } from './SearchDialog';
@@ -147,7 +148,20 @@ export default function Layout({ children, frontmatter }) {
 
         <main className="layout-content" id="main-content">
           <Breadcrumbs />
-          <article>{children}</article>
+          <article>
+            {children}
+            {lastUpdated[currentPath] && (
+              <p className="last-updated">
+                Last updated{' '}
+                {new Date(lastUpdated[currentPath]).toLocaleDateString('en-US', {
+                  year: 'numeric',
+                  month: 'long',
+                  day: 'numeric',
+                })}
+              </p>
+            )}
+          </article>
+
 
           {(prev || next) && (
             <nav className="pagination" aria-label="Page navigation">

lib/generate-last-updated.js

@@ -0,0 +1,45 @@
+const { execSync } = require("child_process");
+const { readdirSync, statSync, writeFileSync } = require("fs");
+const { join, relative } = require("path");
+
+const PAGES_DIR = join(__dirname, "..", "pages");
+const OUTPUT = join(__dirname, "lastUpdated.json");
+
+function walkDir(dir) {
+  const results = [];
+  for (const entry of readdirSync(dir)) {
+    const full = join(dir, entry);
+    if (statSync(full).isDirectory()) {
+      results.push(...walkDir(full));
+    } else if (full.endsWith(".md")) {
+      results.push(full);
+    }
+  }
+  return results;
+}
+
+function getLastUpdated(filePath) {
+  try {
+    const date = execSync(`git log -1 --format="%aI" -- "${filePath}"`, {
+      encoding: "utf-8",
+    }).trim();
+    return date || null;
+  } catch {
+    return null;
+  }
+}
+
+const files = walkDir(PAGES_DIR);
+const map = {};
+
+for (const file of files) {
+  const rel = "/" + relative(PAGES_DIR, file).replace(/\.md$/, "");
+  const route = rel === "/index" ? "/" : rel;
+  const date = getLastUpdated(file);
+  if (date) {
+    map[route] = date;
+  }
+}
+
+writeFileSync(OUTPUT, JSON.stringify(map, null, 2) + "\n");
+console.log(`Generated last-updated dates for ${Object.keys(map).length} pages`);

lib/lastUpdated.json

@@ -0,0 +1,46 @@
+{
+  "/architecture/account-and-identity": "2026-03-05T14:44:33+06:00",
+  "/architecture/data-flow-and-lifecycle": "2026-02-20T13:15:20+01:00",
+  "/architecture/indexers-and-discovery": "2026-03-05T04:01:13+08:00",
+  "/architecture/overview": "2026-03-03T14:42:32+06:00",
+  "/architecture/portability-and-scaling": "2026-03-05T13:01:42+08:00",
+  "/core-concepts/cel-work-scopes": "2026-02-26T16:26:35+01:00",
+  "/core-concepts/certified-identity": "2026-03-05T14:47:53+06:00",
+  "/core-concepts/common-use-cases": "2026-03-05T12:52:26+08:00",
+  "/core-concepts/funding-and-value-flow": "2026-03-05T15:35:21+08:00",
+  "/core-concepts/hypercerts-core-data-model": "2026-03-05T02:45:35+08:00",
+  "/core-concepts/what-is-hypercerts": "2026-03-05T03:40:14+08:00",
+  "/core-concepts/why-at-protocol": "2026-02-20T12:49:43+01:00",
+  "/ecosystem/why-we-need-hypercerts": "2026-02-20T12:49:43+01:00",
+  "/getting-started/building-on-hypercerts": "2026-03-03T16:31:31+08:00",
+  "/getting-started/creating-your-first-hypercert": "2026-03-05T02:45:35+08:00",
+  "/getting-started/quickstart": "2026-03-05T12:57:05+06:00",
+  "/getting-started/testing-and-deployment": "2026-03-05T14:36:55+06:00",
+  "/getting-started/working-with-evaluations": "2026-03-03T14:45:57+08:00",
+  "/": "2026-03-05T13:01:42+08:00",
+  "/lexicons/certified-lexicons/badge-award": "2026-02-20T12:49:43+01:00",
+  "/lexicons/certified-lexicons/badge-definition": "2026-02-20T12:49:43+01:00",
+  "/lexicons/certified-lexicons/badge-response": "2026-02-20T12:49:43+01:00",
+  "/lexicons/certified-lexicons/index": "2026-02-20T12:49:43+01:00",
+  "/lexicons/certified-lexicons/location": "2026-02-20T12:49:43+01:00",
+  "/lexicons/certified-lexicons/profile": "2026-02-20T12:49:43+01:00",
+  "/lexicons/certified-lexicons/shared-defs": "2026-02-20T12:49:43+01:00",
+  "/lexicons/hypercerts-lexicons/acknowledgement": "2026-03-03T14:45:57+08:00",
+  "/lexicons/hypercerts-lexicons/activity-claim": "2026-03-03T14:45:57+08:00",
+  "/lexicons/hypercerts-lexicons/attachment": "2026-03-03T14:45:57+08:00",
+  "/lexicons/hypercerts-lexicons/collection": "2026-03-03T14:45:57+08:00",
+  "/lexicons/hypercerts-lexicons/contribution": "2026-03-03T14:45:57+08:00",
+  "/lexicons/hypercerts-lexicons/evaluation": "2026-03-03T14:45:57+08:00",
+  "/lexicons/hypercerts-lexicons/funding-receipt": "2026-03-03T14:45:57+08:00",
+  "/lexicons/hypercerts-lexicons/index": "2026-02-20T19:42:03+08:00",
+  "/lexicons/hypercerts-lexicons/measurement": "2026-03-03T14:45:57+08:00",
+  "/lexicons/hypercerts-lexicons/rights": "2026-03-03T14:45:57+08:00",
+  "/lexicons/introduction-to-lexicons": "2026-02-20T12:49:43+01:00",
+  "/reference/faq": "2026-03-05T12:57:05+06:00",
+  "/reference/glossary": "2026-03-05T12:57:05+06:00",
+  "/roadmap": "2026-03-03T14:45:57+08:00",
+  "/tools/hyperboards": "2026-03-03T14:45:57+08:00",
+  "/tools/hypercerts-cli": "2026-03-05T12:30:00+06:00",
+  "/tools/hyperindex": "2026-02-20T19:42:03+08:00",
+  "/tools/scaffold": "2026-03-05T15:58:36+06:00"
+}

package.json

@@ -4,8 +4,8 @@
   "private": true,
   "description": "Hypercerts Protocol Documentation",
   "scripts": {
-    "dev": "next dev --webpack",
-    "build": "next build --webpack",
+    "dev": "node lib/generate-last-updated.js && next dev --webpack",
+    "build": "node lib/generate-last-updated.js && next build --webpack",
     "start": "next start"
   },
   "dependencies": {

pages/core-concepts/hypercerts-core-data-model.md

@@ -5,8 +5,6 @@ description: The data model behind hypercerts — record types, dimensions, and
 
 # Core Data Model
 
-*Last updated: March 5, 2026*
-
 A hypercert is an [activity claim](/lexicons/hypercerts-lexicons/activity-claim) with linked records that describe work done. The activity claim is the anchor — contributions, attachments, measurements, and evaluations reference it to add context.
 
 This page explains what records exist, what they contain, and how they connect.

styles/globals.css

@@ -939,11 +939,33 @@ a.sidebar-link-active:hover {
   font-size: 13px;
 }
 
+/* ===== Last Updated ===== */
+article:has(.last-updated) {
+  display: flex;
+  flex-direction: column;
+}
+
+article:has(.last-updated) > article {
+  display: contents;
+}
+
+article:has(.last-updated) > article > h1:first-child {
+  order: -2;
+}
+
+.last-updated {
+  order: -1;
+  margin-bottom: var(--space-6);
+  padding-bottom: var(--space-2);
+  border-bottom: 1px solid var(--color-border);
+  font-size: 0.8125rem;
+  color: var(--color-text-secondary);
+}
 /* ===== Pagination ===== */
 .pagination {
   display: flex;
   justify-content: space-between;
-  margin-top: var(--space-12);
+  margin-top: var(--space-6);
   padding-top: var(--space-6);
   border-top: 1px solid var(--color-border);
   gap: var(--space-4);