From d1cbf8256b53aad205048bf8794e6c38d9c1cfd6 Mon Sep 17 00:00:00 2001
From: multipleof4 <planetrenox@protonmail.com>
Date: Tue, 24 Feb 2026 18:38:57 -0800
Subject: [PATCH] Feat: Full project readme with structure docs

---
 readme.md | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/readme.md b/readme.md
index e6647cd..b4c4413 100644
--- a/readme.md
+++ b/readme.md
@@ -1 +1,25 @@
 ## The news outlet for pattern seekers
+
+### Structure
+
+```
+articles/
+  why-pigeons-watch-you/
+    index.md          ← frontmatter + markdown
+    pigeon-wire.webp  ← co-located assets
+templates/
+  article.html        ← shared article shell
+  home.html           ← index page
+static/
+  style.css
+  favicon.svg
+build.js              ← markdown → dist pipeline
+```
+
+### Usage
+
+```bash
+npm i
+npm run build    # outputs to dist/
+npm run dev      # vite dev server
+```