From 05cfbad4adf5a827b128349541d5c77295b8997d Mon Sep 17 00:00:00 2001
From: bot-implementer <bot-implementer@stevanovic.co.uk>
Date: Tue, 25 Aug 2026 12:30:06 +0000
Subject: [PATCH] feat: add curated reading list data file

Single source of truth for the reading list page. Entries carry a title,
url, category, and an optional one-line note; adding a link means editing
this file only.
---
 data/reading-list.js | 82 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 82 insertions(+)
 create mode 100644 data/reading-list.js

diff --git a/data/reading-list.js b/data/reading-list.js
new file mode 100644
index 0000000..fd06a7c
--- /dev/null
+++ b/data/reading-list.js
@@ -0,0 +1,82 @@
+/**
+ * Curated reading list — the single source of truth for the reading list page.
+ *
+ * Each entry:
+ *   title    — link text shown on the page (required)
+ *   url      — absolute http(s) URL the title links to (required)
+ *   note     — optional one-line note shown under the title
+ *   category — heading the entry is grouped under (required)
+ *
+ * Entries appear on the page in the order they are listed here, and categories
+ * appear in the order they are first used.
+ *
+ * To add a link, edit this file only — no page or code changes are needed.
+ */
+export const READING_LIST = [
+  // Design
+  {
+    category: "Design",
+    title: "Refactoring UI",
+    url: "https://www.refactoringui.com/",
+    note: "Practical visual-design tactics for developers.",
+  },
+  {
+    category: "Design",
+    title: "A List Apart",
+    url: "https://alistapart.com/",
+    note: "Long-running essays on web design and development.",
+  },
+  {
+    category: "Design",
+    title: "Laws of UX",
+    url: "https://lawsofux.com/",
+    note: "Design principles as quick-reference cards.",
+  },
+
+  // Engineering
+  {
+    category: "Engineering",
+    title: "The Twelve-Factor App",
+    url: "https://12factor.net/",
+    note: "Methodology for building modern, portable web services.",
+  },
+  {
+    category: "Engineering",
+    title: "MDN Web Docs",
+    url: "https://developer.mozilla.org/",
+    note: "The web reference I reach for first.",
+  },
+  {
+    category: "Engineering",
+    title: "Refactoring Guru",
+    url: "https://refactoring.guru/",
+    note: "Design patterns and refactoring, with diagrams.",
+  },
+  {
+    category: "Engineering",
+    title: "How to Ask Questions the Smart Way",
+    url: "http://www.catb.org/esr/faqs/smart-questions.html",
+  },
+
+  // Typography
+  {
+    category: "Typography",
+    title: "Butterick's Practical Typography",
+    url: "https://practicaltypography.com/",
+    note: "Typography rules, explained in plain English.",
+  },
+  {
+    category: "Typography",
+    title: "Fonts in Use",
+    url: "https://fontsinuse.com/",
+    note: "Real-world examples of type in action.",
+  },
+
+  // Writing
+  {
+    category: "Writing",
+    title: "Paul Graham's Essays",
+    url: "http://www.paulgraham.com/articles.html",
+    note: "Essays on startups, writing, and thinking.",
+  },
+];