diff --git a/readme.md b/readme.md
index 4d7a91a..1f89008 100644
--- a/readme.md
+++ b/readme.md
@@ -1,2 +1,16 @@
 ## The news outlet for pattern seekers
 
+Light-themed static publication engine for **apophenia.news**, built with:
+
+- Vite
+- TailwindCSS
+- Alpine.js
+- Lucide icons
+- Markdown-driven article generation
+- GitHub Actions auto-build to `dist/`
+
+### Local development
+
+```bash
+npm install
+npm run dev