From ba5500710cf6380d6d1107fc4e8f16f128a9b642 Mon Sep 17 00:00:00 2001
From: sam <samuelrolfe@gmail.com>
Date: Thu, 10 Sep 2026 09:43:52 +1000
Subject: [PATCH] docs(DESIGN): add media model note (git files beside article;
 no S3); garage bucket+keys deleted

---
 DESIGN.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/DESIGN.md b/DESIGN.md
index 221c954..f1e636d 100644
--- a/DESIGN.md
+++ b/DESIGN.md
@@ -164,6 +164,14 @@ Brand: **Kontra** (centered masthead). Home section heading: **Topics** (not "By
 
 Reference implementation: `prototype/` (index.html, article.html, assets/kontra.css).
 
+## Media (implementation note)
+
+- Images are **git files beside their article**: `content/subjects/<s>/<slug>/<file>`.
+  Reference via `{{media:<slug>/<file>}}` (front-matter `image:` MUST be quoted —
+  `image: "{{media:slug/file.jpg}}"`). The app serves `/media/<path>` by searching
+  article folders (safe-path guarded). No S3/object store (Garage dropped 2026-09-10).
+- Hero image: grayscale plate per §Hero plate; leave `image: ""` for text-only pieces.
+
 ## Token wiring (for the theme)
 
 - Implement as CSS custom properties on `:root` (the design-token layer).