From d486e122dec9f35d1c86f69ff47315742147e3ca Mon Sep 17 00:00:00 2001
From: Jesper Pedersen <pejes@aarhus.dk>
Date: Wed, 22 Apr 2026 15:48:11 +0200
Subject: [PATCH] feat: add "Last edited" dates to home page project cards

Replace default VitePress feature cards with a custom HomeFeatures
component that shows git-sourced last edited timestamps on each card.

- Build-time data loader reads git log for each project folder
- Custom component renders cards matching VitePress style with date line
- Dates update automatically on every commit that touches project files

Co-authored-by: Claude <noreply@anthropic.com>
---
 CHANGELOG.md                               |   5 +
 docs/.vitepress/theme/DocLayout.vue        |   5 +
 docs/.vitepress/theme/HomeFeatures.vue     | 188 +++++++++++++++++++++
 docs/.vitepress/theme/custom.css           |   5 +
 docs/.vitepress/theme/projectDates.data.js |  35 ++++
 5 files changed, 238 insertions(+)
 create mode 100644 docs/.vitepress/theme/HomeFeatures.vue
 create mode 100644 docs/.vitepress/theme/projectDates.data.js

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7ef1f82..87100d8 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,11 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+### Added
+- "Last edited" dates on home page project cards, sourced from git commit timestamps
+- Custom HomeFeatures component replacing default VitePress feature cards
+- Build-time data loader for project git timestamps
+
 ### Added — WCAG Contrast Checker Project
 - Color contrast accessibility tool for analyzing WCAG AA/AAA compliance
 - Interactive prototype with CSV upload, manual input, and Danish municipal sample palettes
diff --git a/docs/.vitepress/theme/DocLayout.vue b/docs/.vitepress/theme/DocLayout.vue
index ffbce16..cbc03e5 100644
--- a/docs/.vitepress/theme/DocLayout.vue
+++ b/docs/.vitepress/theme/DocLayout.vue
@@ -1,6 +1,7 @@
 <script setup>
 import DefaultTheme from 'vitepress/theme'
 import PasswordGate from './PasswordGate.vue'
+import HomeFeatures from './HomeFeatures.vue'
 import { useData } from 'vitepress'
 import { computed } from 'vue'
 
@@ -8,6 +9,7 @@ const { Layout } = DefaultTheme
 const { frontmatter, page } = useData()
 
 const isProtected = computed(() => !!frontmatter.value.protected)
+const isHome = computed(() => frontmatter.value.layout === 'home')
 
 const lastUpdated = computed(() => {
   if (!page.value.lastUpdated) return null
@@ -39,6 +41,9 @@ const hasInfo = computed(() => frontmatter.value.authors?.length || lastUpdated.
         </span>
       </div>
     </template>
+    <template #home-features-before>
+      <HomeFeatures v-if="isHome" />
+    </template>
   </Layout>
 </template>
 
diff --git a/docs/.vitepress/theme/HomeFeatures.vue b/docs/.vitepress/theme/HomeFeatures.vue
new file mode 100644
index 0000000..2d7b003
--- /dev/null
+++ b/docs/.vitepress/theme/HomeFeatures.vue
@@ -0,0 +1,188 @@
+<script setup>
+import { computed } from 'vue'
+import { useData, withBase } from 'vitepress'
+import { data as projectDates } from './projectDates.data.js'
+
+const { frontmatter } = useData()
+
+function formatDate(isoString) {
+  if (!isoString) return null
+  return new Date(isoString).toLocaleString('da-DK', {
+    day: 'numeric',
+    month: 'short',
+    year: 'numeric',
+    hour: '2-digit',
+    minute: '2-digit',
+    hour12: false,
+  })
+}
+
+const features = computed(() => {
+  return (frontmatter.value.features || []).map(f => ({
+    ...f,
+    lastEdited: formatDate(projectDates[f.link]),
+  }))
+})
+
+const grid = computed(() => {
+  const length = features.value.length
+  if (!length) return
+  if (length === 2) return 'grid-2'
+  if (length === 3) return 'grid-3'
+  if (length % 3 === 0) return 'grid-6'
+  if (length > 3) return 'grid-4'
+})
+</script>
+
+<template>
+  <div v-if="features.length" class="VPFeatures custom-features">
+    <div class="container">
+      <div class="items">
+        <div
+          v-for="feature in features"
+          :key="feature.title"
+          class="item"
+          :class="[grid]"
+        >
+          <a
+            class="VPFeature link"
+            :href="withBase(feature.link)"
+          >
+            <article class="box">
+              <h2 class="title" v-html="feature.title"></h2>
+              <p v-if="feature.details" class="details" v-html="feature.details"></p>
+              <p v-if="feature.lastEdited" class="last-edited">
+                Last edited: {{ feature.lastEdited }}
+              </p>
+              <div v-if="feature.linkText" class="link-text">
+                <p class="link-text-value">
+                  {{ feature.linkText }} <span class="vpi-arrow-right link-text-icon" />
+                </p>
+              </div>
+            </article>
+          </a>
+        </div>
+      </div>
+    </div>
+  </div>
+</template>
+
+<style scoped>
+.VPFeatures {
+  position: relative;
+  padding: 0 24px;
+}
+
+@media (min-width: 640px) {
+  .VPFeatures {
+    padding: 0 48px;
+  }
+}
+
+@media (min-width: 960px) {
+  .VPFeatures {
+    padding: 0 64px;
+  }
+}
+
+.container {
+  margin: 0 auto;
+  max-width: 1152px;
+}
+
+.items {
+  display: flex;
+  flex-wrap: wrap;
+  margin: -8px;
+}
+
+.item {
+  padding: 8px;
+  width: 100%;
+}
+
+@media (min-width: 640px) {
+  .item.grid-2,
+  .item.grid-4,
+  .item.grid-6 {
+    width: calc(100% / 2);
+  }
+}
+
+@media (min-width: 768px) {
+  .item.grid-2,
+  .item.grid-4 {
+    width: calc(100% / 2);
+  }
+
+  .item.grid-3,
+  .item.grid-6 {
+    width: calc(100% / 3);
+  }
+}
+
+@media (min-width: 960px) {
+  .item.grid-4 {
+    width: calc(100% / 4);
+  }
+}
+
+.VPFeature {
+  display: block;
+  border: 1px solid var(--vp-c-bg-soft);
+  border-radius: 12px;
+  height: 100%;
+  background-color: var(--vp-c-bg-soft);
+  transition: border-color 0.25s, background-color 0.25s;
+  text-decoration: none;
+  color: inherit;
+}
+
+.VPFeature.link:hover {
+  border-color: var(--vp-c-brand-1);
+}
+
+.box {
+  display: flex;
+  flex-direction: column;
+  padding: 24px;
+  height: 100%;
+}
+
+.title {
+  line-height: 24px;
+  font-size: 16px;
+  font-weight: 600;
+}
+
+.details {
+  flex-grow: 1;
+  padding-top: 8px;
+  line-height: 24px;
+  font-size: 14px;
+  font-weight: 500;
+  color: var(--vp-c-text-2);
+}
+
+.last-edited {
+  padding-top: 8px;
+  font-size: 12px;
+  color: var(--vp-c-text-3);
+}
+
+.link-text {
+  padding-top: 8px;
+}
+
+.link-text-value {
+  display: flex;
+  align-items: center;
+  font-size: 14px;
+  font-weight: 500;
+  color: var(--vp-c-brand-1);
+}
+
+.link-text-icon {
+  margin-left: 6px;
+}
+</style>
diff --git a/docs/.vitepress/theme/custom.css b/docs/.vitepress/theme/custom.css
index 9bf0f70..f81f974 100644
--- a/docs/.vitepress/theme/custom.css
+++ b/docs/.vitepress/theme/custom.css
@@ -53,3 +53,8 @@
 .VPFeature .VPImage {
   filter: opacity(0.6);
 }
+
+/* Hide default VPHomeFeatures — replaced by custom HomeFeatures component */
+.VPHomeFeatures {
+  display: none !important;
+}
diff --git a/docs/.vitepress/theme/projectDates.data.js b/docs/.vitepress/theme/projectDates.data.js
new file mode 100644
index 0000000..87a34d8
--- /dev/null
+++ b/docs/.vitepress/theme/projectDates.data.js
@@ -0,0 +1,35 @@
+import { execSync } from 'child_process'
+import { readdirSync, statSync } from 'fs'
+import { join } from 'path'
+
+const projectsDir = join(import.meta.dirname, '../../projects')
+
+export default {
+  load() {
+    const dates = {}
+    let dirs
+    try {
+      dirs = readdirSync(projectsDir).filter(name => {
+        return statSync(join(projectsDir, name)).isDirectory()
+      })
+    } catch {
+      return dates
+    }
+
+    for (const dir of dirs) {
+      const projectPath = `/projects/${dir}/`
+      try {
+        const timestamp = execSync(
+          `git log -1 --format=%cI -- "docs/projects/${dir}"`,
+          { encoding: 'utf-8', cwd: join(projectsDir, '../..') }
+        ).trim()
+        if (timestamp) {
+          dates[projectPath] = timestamp
+        }
+      } catch {
+        // skip if git fails
+      }
+    }
+    return dates
+  }
+}