From 49a079393b967b53a5a550a319f2ade9b7990a26 Mon Sep 17 00:00:00 2001
From: Alexander Sullivan <alexander.joohyun.sullivan@gmail.com>
Date: Mon, 5 Jan 2026 21:47:45 -0500
Subject: [PATCH 1/2] update sentry version

---
 index.html        |  29 ++---
 package-lock.json | 270 ++++++++++++++++++++++++++++------------------
 package.json      |  10 +-
 3 files changed, 186 insertions(+), 123 deletions(-)

diff --git a/index.html b/index.html
index 239b6d4..fddf118 100644
--- a/index.html
+++ b/index.html
@@ -122,31 +122,32 @@
 			crossorigin="anonymous"
 		></script>
 		<script
-			src="https://browser.sentry-cdn.com/7.113.0/bundle.tracing.replay.min.js"
-			integrity="sha384-wXgzLdc+RJ2eAiFpbvC5qUGzPUApNnMOI/DBvb1hSu8Zo4J/7NkxmP4DvBmNvWbQ"
+			src="https://browser.sentry-cdn.com/10.32.1/bundle.tracing.replay.min.js"
+			integrity="sha384-s+BQx+x7H3WSg8yxXYpSU50E6bL5JlJPzwIBPfSB0kXLFbgPIIwYZSgg68cUA2t4"
 			crossorigin="anonymous"
 		></script>
-
 		<script
-			src="https://browser.sentry-cdn.com/7.113.0/captureconsole.min.js"
-			integrity="sha384-H94VNEVI1G7X5bbKxVSFigZ//BDP5XFYQrGnxeivk1WgakI45En7H9m2DSeHmcmY"
+			src="https://browser.sentry-cdn.com/10.32.1/captureconsole.min.js"
+			integrity="sha384-n1EDDTBm8n6jrDs8cT8XGEK4TKzeefAwaBC8N9NYi/olGXl3qkmV2ISKdYjuskDp"
 			crossorigin="anonymous"
 		></script>
 		<script>
 			Sentry.init({
-				dsn: "https://c74a8d7e001f45c8bb4ebfa5a1e92664@o1185775.ingest.sentry.io/6600431",
-				// @AlexJSully when updating the package version number in package.json, update the version number here as well.
+				dsn: "https://c74a8d7e001f45c8bb4ebfa5a1e92664@o1185775.ingest.us.sentry.io/6600431",
+				// When updating the package version number in package.json, update the version number here as well.
 				release: "small-dev-talk@1.3.4",
 
-				integrations: [
-					new Sentry.BrowserTracing(),
-					new Sentry.Integrations.CaptureConsole({
-						levels: ["error"],
-					}),
-				],
+				integrations: [Sentry.browserTracingIntegration(), Sentry.replayIntegration()],
+
+				// Enable logs to be sent to Sentry
+				enableLogs: true,
 
-				// We recommend adjusting this value in production, or using tracesSampler for finer control
 				tracesSampleRate: 1.0,
+
+				// Capture Replay for 10% of all sessions,
+				// plus for 100% of sessions with an error
+				replaysSessionSampleRate: 0.1,
+				replaysOnErrorSampleRate: 1.0,
 			});
 
 			Sentry.configureScope((scope) => {
diff --git a/package-lock.json b/package-lock.json
index 9601170..4501aa0 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -9,17 +9,17 @@
 			"version": "1.3.4",
 			"license": "GPL-3.0",
 			"devDependencies": {
-				"cypress": "^15.7.1",
-				"eslint": "^9.39.1",
+				"cypress": "^15.8.1",
+				"eslint": "^9.39.2",
 				"eslint-config-prettier": "^10.1.8",
 				"eslint-plugin-cypress": "^5.2.0",
 				"eslint-plugin-prettier": "^5.5.4",
-				"globals": "^16.5.0",
+				"globals": "^17.0.0",
 				"http-server": "^14.1.1",
 				"jest": "^30.2.0",
 				"jest-environment-jsdom": "^30.2.0",
-				"markdownlint-cli": "^0.46.0",
-				"prettier": "^3.7.3",
+				"markdownlint-cli": "^0.47.0",
+				"prettier": "^3.7.4",
 				"start-server-and-test": "^2.1.3",
 				"workbox-cli": "^7.4.0"
 			}
@@ -1918,9 +1918,9 @@
 			}
 		},
 		"node_modules/@cypress/request": {
-			"version": "3.0.9",
-			"resolved": "https://registry.npmjs.org/@cypress/request/-/request-3.0.9.tgz",
-			"integrity": "sha512-I3l7FdGRXluAS44/0NguwWlO83J18p0vlr2FYHrJkWdNYhgVoiYo61IXPqaOsL+vNxU1ZqMACzItGK3/KKDsdw==",
+			"version": "3.0.10",
+			"resolved": "https://registry.npmjs.org/@cypress/request/-/request-3.0.10.tgz",
+			"integrity": "sha512-hauBrOdvu08vOsagkZ/Aju5XuiZx6ldsLfByg1htFeldhex+PeMrYauANzFsMJeAA0+dyPLbDoX2OYuvVoLDkQ==",
 			"dev": true,
 			"license": "Apache-2.0",
 			"dependencies": {
@@ -1937,7 +1937,7 @@
 				"json-stringify-safe": "~5.0.1",
 				"mime-types": "~2.1.19",
 				"performance-now": "^2.1.0",
-				"qs": "6.14.0",
+				"qs": "~6.14.1",
 				"safe-buffer": "^5.1.2",
 				"tough-cookie": "^5.0.0",
 				"tunnel-agent": "^0.6.0",
@@ -1969,9 +1969,9 @@
 			}
 		},
 		"node_modules/@emnapi/core": {
-			"version": "1.7.1",
-			"resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.7.1.tgz",
-			"integrity": "sha512-o1uhUASyo921r2XtHYOHy7gdkGLge8ghBEQHMWmyJFoXlpU58kIrhhN3w26lpQb6dspetweapMn2CSNwQ8I4wg==",
+			"version": "1.8.1",
+			"resolved": "https://registry.npmjs.org/@emnapi/core/-/core-1.8.1.tgz",
+			"integrity": "sha512-AvT9QFpxK0Zd8J0jopedNm+w/2fIzvtPKPjqyw9jwvBaReTTqPBk9Hixaz7KbjimP+QNz605/XnjFcDAL2pqBg==",
 			"dev": true,
 			"license": "MIT",
 			"optional": true,
@@ -1981,9 +1981,9 @@
 			}
 		},
 		"node_modules/@emnapi/runtime": {
-			"version": "1.7.1",
-			"resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.7.1.tgz",
-			"integrity": "sha512-PVtJr5CmLwYAU9PZDMITZoR5iAOShYREoR45EyyLrbntV50mdePTgUn4AmOw90Ifcj+x2kRjdzr1HP3RrNiHGA==",
+			"version": "1.8.1",
+			"resolved": "https://registry.npmjs.org/@emnapi/runtime/-/runtime-1.8.1.tgz",
+			"integrity": "sha512-mehfKSMWjjNol8659Z8KxEMrdSJDDot5SXMq00dM8BN4o+CLNXQ0xH2V7EchNHV4RmbZLmmPdEaXZc5H2FXmDg==",
 			"dev": true,
 			"license": "MIT",
 			"optional": true,
@@ -2003,9 +2003,9 @@
 			}
 		},
 		"node_modules/@eslint-community/eslint-utils": {
-			"version": "4.9.0",
-			"resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.9.0.tgz",
-			"integrity": "sha512-ayVFHdtZ+hsq1t2Dy24wCmGXGe4q9Gu3smhLYALJrr473ZH27MsnSL+LKUlimp4BWJqMDMLmPpx/Q9R3OAlL4g==",
+			"version": "4.9.1",
+			"resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.9.1.tgz",
+			"integrity": "sha512-phrYmNiYppR7znFEdqgfWHXR6NCkZEK7hwWDHZUjit/2/U0r6XvkDl0SYnoM51Hq7FhCGdLDT6zxCCOY1hexsQ==",
 			"dev": true,
 			"license": "MIT",
 			"dependencies": {
@@ -2123,9 +2123,9 @@
 			}
 		},
 		"node_modules/@eslint/js": {
-			"version": "9.39.1",
-			"resolved": "https://registry.npmjs.org/@eslint/js/-/js-9.39.1.tgz",
-			"integrity": "sha512-S26Stp4zCy88tH94QbBv3XCuzRQiZ9yXofEILmglYTh/Ug/a9/umqvgFtYBAo3Lp0nsI/5/qH1CCrbdK3AP1Tw==",
+			"version": "9.39.2",
+			"resolved": "https://registry.npmjs.org/@eslint/js/-/js-9.39.2.tgz",
+			"integrity": "sha512-q1mjIoW1VX4IvSocvM/vbTiveKC4k9eLrajNEuSsmjymSDEbpGddtpfOoN7YGAqBK3NG+uqo8ia4PDTt8buCYA==",
 			"dev": true,
 			"license": "MIT",
 			"engines": {
@@ -3145,9 +3145,9 @@
 			"license": "MIT"
 		},
 		"node_modules/@sinclair/typebox": {
-			"version": "0.34.41",
-			"resolved": "https://registry.npmjs.org/@sinclair/typebox/-/typebox-0.34.41.tgz",
-			"integrity": "sha512-6gS8pZzSXdyRHTIqoqSVknxolr1kzfy4/CeDnrzsVz8TTIWUbOBr6gnzOmTYJ3eXQNh4IYHIGi5aIL7sOZ2G/g==",
+			"version": "0.34.46",
+			"resolved": "https://registry.npmjs.org/@sinclair/typebox/-/typebox-0.34.46.tgz",
+			"integrity": "sha512-kiW7CtS/NkdvTUjkjUJo7d5JsFfbJ14YjdhDk9KoEgK6nFjKNXZPrX0jfLA8ZlET4cFLHxOZ/0vFKOP+bOxIOQ==",
 			"dev": true,
 			"license": "MIT"
 		},
@@ -3172,9 +3172,9 @@
 			}
 		},
 		"node_modules/@standard-schema/spec": {
-			"version": "1.0.0",
-			"resolved": "https://registry.npmjs.org/@standard-schema/spec/-/spec-1.0.0.tgz",
-			"integrity": "sha512-m2bOd0f2RT9k8QJx1JN85cZYyH1RqFBdlwtkSlf4tBDYLCiiZnv1fIIwacK6cqwXavOydf0NPToMQgpKq+dVlA==",
+			"version": "1.1.0",
+			"resolved": "https://registry.npmjs.org/@standard-schema/spec/-/spec-1.1.0.tgz",
+			"integrity": "sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w==",
 			"dev": true,
 			"license": "MIT"
 		},
@@ -3332,9 +3332,9 @@
 			"license": "MIT"
 		},
 		"node_modules/@types/node": {
-			"version": "24.10.1",
-			"resolved": "https://registry.npmjs.org/@types/node/-/node-24.10.1.tgz",
-			"integrity": "sha512-GNWcUTRBgIRJD5zj+Tq0fKOJ5XZajIiBroOF0yvj2bSU1WvNdYS/dn9UxwsujGW4JX06dnHyjV2y9rRaybH0iQ==",
+			"version": "25.0.3",
+			"resolved": "https://registry.npmjs.org/@types/node/-/node-25.0.3.tgz",
+			"integrity": "sha512-W609buLVRVmeW693xKfzHeIV6nJGGz98uCPfeXI1ELMLXVeKYZ9m15fAMSaUPBHYLGFsVRcMmSCksQOrZV9BYA==",
 			"dev": true,
 			"license": "MIT",
 			"dependencies": {
@@ -4243,9 +4243,9 @@
 			"license": "MIT"
 		},
 		"node_modules/baseline-browser-mapping": {
-			"version": "2.8.32",
-			"resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.8.32.tgz",
-			"integrity": "sha512-OPz5aBThlyLFgxyhdwf/s2+8ab3OvT7AdTNvKHBwpXomIYeXqpUUuT8LrdtxZSsWJ4R4CU1un4XGh5Ez3nlTpw==",
+			"version": "2.9.11",
+			"resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.9.11.tgz",
+			"integrity": "sha512-Sg0xJUNDU1sJNGdfGWhVHX0kkZ+HWcvmVymJbj6NSgZZmW/8S9Y2HQ5euytnIgakgxN6papOAWiwDo1ctFDcoQ==",
 			"dev": true,
 			"license": "Apache-2.0",
 			"bin": {
@@ -4493,9 +4493,9 @@
 			}
 		},
 		"node_modules/browserslist": {
-			"version": "4.28.0",
-			"resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.28.0.tgz",
-			"integrity": "sha512-tbydkR/CxfMwelN0vwdP/pLkDwyAASZ+VfWm4EOwlB6SWhx1sYnWLqo8N5j0rAzPfzfRaxt0mM/4wPU/Su84RQ==",
+			"version": "4.28.1",
+			"resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.28.1.tgz",
+			"integrity": "sha512-ZC5Bd0LgJXgwGqUknZY/vkUQ04r8NXnJZ3yYi4vDmSiZmC/pdSN0NbNRPxZpbtO4uAfDUAFffO8IZoM3Gj8IkA==",
 			"dev": true,
 			"funding": [
 				{
@@ -4514,11 +4514,11 @@
 			"license": "MIT",
 			"peer": true,
 			"dependencies": {
-				"baseline-browser-mapping": "^2.8.25",
-				"caniuse-lite": "^1.0.30001754",
-				"electron-to-chromium": "^1.5.249",
+				"baseline-browser-mapping": "^2.9.0",
+				"caniuse-lite": "^1.0.30001759",
+				"electron-to-chromium": "^1.5.263",
 				"node-releases": "^2.0.27",
-				"update-browserslist-db": "^1.1.4"
+				"update-browserslist-db": "^1.2.0"
 			},
 			"bin": {
 				"browserslist": "cli.js"
@@ -4678,9 +4678,9 @@
 			}
 		},
 		"node_modules/caniuse-lite": {
-			"version": "1.0.30001757",
-			"resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001757.tgz",
-			"integrity": "sha512-r0nnL/I28Zi/yjk1el6ilj27tKcdjLsNqAOZr0yVjWPrSQyHgKI2INaEWw21bAQSv2LXRt1XuCS/GomNpWOxsQ==",
+			"version": "1.0.30001762",
+			"resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001762.tgz",
+			"integrity": "sha512-PxZwGNvH7Ak8WX5iXzoK1KPZttBXNPuaOvI2ZYU7NrlM+d9Ov+TUvlLOBNGzVXAntMSMMlJPd+jY6ovrVjSmUw==",
 			"dev": true,
 			"funding": [
 				{
@@ -4850,9 +4850,9 @@
 			}
 		},
 		"node_modules/cjs-module-lexer": {
-			"version": "2.1.1",
-			"resolved": "https://registry.npmjs.org/cjs-module-lexer/-/cjs-module-lexer-2.1.1.tgz",
-			"integrity": "sha512-+CmxIZ/L2vNcEfvNtLdU0ZQ6mbq3FZnwAP2PPTiKP+1QOoKwlKlPgb8UKV0Dds7QVaMnHm+FwSft2VB0s/SLjQ==",
+			"version": "2.2.0",
+			"resolved": "https://registry.npmjs.org/cjs-module-lexer/-/cjs-module-lexer-2.2.0.tgz",
+			"integrity": "sha512-4bHTS2YuzUvtoLjdy+98ykbNB5jS0+07EvFNXerqZQJ89F7DI6ET7OQo/HJuW6K0aVsKA9hj9/RVb2kQVOrPDQ==",
 			"dev": true,
 			"license": "MIT"
 		},
@@ -5202,9 +5202,9 @@
 			}
 		},
 		"node_modules/cypress": {
-			"version": "15.7.1",
-			"resolved": "https://registry.npmjs.org/cypress/-/cypress-15.7.1.tgz",
-			"integrity": "sha512-U3sYnJ+Cnpgr6IPycxsznTg//mGVXfPGeGV+om7VQCyp5XyVkhG4oPr3X3hTq1+OB0Om0O5DxusYmt7cbvwqMQ==",
+			"version": "15.8.1",
+			"resolved": "https://registry.npmjs.org/cypress/-/cypress-15.8.1.tgz",
+			"integrity": "sha512-ogc62stTQGh1395ipKxfCE5hQuSApTzeH5e0d9U6m7wYO9HQeCpgnkYtBtd0MbkN2Fnch5Od2mX9u4hoTlrH4Q==",
 			"dev": true,
 			"hasInstallScript": true,
 			"license": "MIT",
@@ -5246,7 +5246,7 @@
 				"proxy-from-env": "1.0.0",
 				"request-progress": "^3.0.0",
 				"supports-color": "^8.1.1",
-				"systeminformation": "5.27.7",
+				"systeminformation": "^5.27.14",
 				"tmp": "~0.2.4",
 				"tree-kill": "1.2.2",
 				"untildify": "^4.0.0",
@@ -5424,9 +5424,9 @@
 			}
 		},
 		"node_modules/dedent": {
-			"version": "1.7.0",
-			"resolved": "https://registry.npmjs.org/dedent/-/dedent-1.7.0.tgz",
-			"integrity": "sha512-HGFtf8yhuhGhqO07SV79tRp+br4MnbdjeVxotpn1QBl30pcLLCQjX5b2295ll0fv8RKDKsmWYrl05usHM9CewQ==",
+			"version": "1.7.1",
+			"resolved": "https://registry.npmjs.org/dedent/-/dedent-1.7.1.tgz",
+			"integrity": "sha512-9JmrhGZpOlEgOLdQgSm0zxFaYoQon408V1v49aqTWuXENVlnCuY9JBZcXZiCsZQWDjTm5Qf/nIvAy77mXDAjEg==",
 			"dev": true,
 			"license": "MIT",
 			"peerDependencies": {
@@ -5644,9 +5644,9 @@
 			}
 		},
 		"node_modules/electron-to-chromium": {
-			"version": "1.5.263",
-			"resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.263.tgz",
-			"integrity": "sha512-DrqJ11Knd+lo+dv+lltvfMDLU27g14LMdH2b0O3Pio4uk0x+z7OR+JrmyacTPN2M8w3BrZ7/RTwG3R9B7irPlg==",
+			"version": "1.5.267",
+			"resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.267.tgz",
+			"integrity": "sha512-0Drusm6MVRXSOJpGbaSVgcQsuB4hEkMpHXaVstcPmhu5LIedxs1xNK/nIxmQIU/RPC0+1/o0AVZfBTkTNJOdUw==",
 			"dev": true,
 			"license": "ISC"
 		},
@@ -5719,9 +5719,9 @@
 			}
 		},
 		"node_modules/es-abstract": {
-			"version": "1.24.0",
-			"resolved": "https://registry.npmjs.org/es-abstract/-/es-abstract-1.24.0.tgz",
-			"integrity": "sha512-WSzPgsdLtTcQwm4CROfS5ju2Wa1QQcVeT37jFjYzdFz1r9ahadC8B8/a4qxJxM+09F18iumCdRmlr96ZYkQvEg==",
+			"version": "1.24.1",
+			"resolved": "https://registry.npmjs.org/es-abstract/-/es-abstract-1.24.1.tgz",
+			"integrity": "sha512-zHXBLhP+QehSSbsS9Pt23Gg964240DPd6QCf8WpkqEXxQ7fhdZzYsocOr5u7apWonsS5EjZDmTF+/slGMyasvw==",
 			"dev": true,
 			"license": "MIT",
 			"dependencies": {
@@ -5891,9 +5891,9 @@
 			}
 		},
 		"node_modules/eslint": {
-			"version": "9.39.1",
-			"resolved": "https://registry.npmjs.org/eslint/-/eslint-9.39.1.tgz",
-			"integrity": "sha512-BhHmn2yNOFA9H9JmmIVKJmd288g9hrVRDkdoIgRCRuSySRUHH7r/DI6aAXW9T1WwUuY3DFgrcaqB+deURBLR5g==",
+			"version": "9.39.2",
+			"resolved": "https://registry.npmjs.org/eslint/-/eslint-9.39.2.tgz",
+			"integrity": "sha512-LEyamqS7W5HB3ujJyvi0HQK/dtVINZvd5mAAp9eT5S/ujByGjiZLCzPcHVzuXbpJDJF/cxwHlfceVUDZ2lnSTw==",
 			"dev": true,
 			"license": "MIT",
 			"peer": true,
@@ -5904,7 +5904,7 @@
 				"@eslint/config-helpers": "^0.4.2",
 				"@eslint/core": "^0.17.0",
 				"@eslint/eslintrc": "^3.3.1",
-				"@eslint/js": "9.39.1",
+				"@eslint/js": "9.39.2",
 				"@eslint/plugin-kit": "^0.4.1",
 				"@humanfs/node": "^0.16.6",
 				"@humanwhocodes/module-importer": "^1.0.1",
@@ -5981,6 +5981,19 @@
 				"eslint": ">=9"
 			}
 		},
+		"node_modules/eslint-plugin-cypress/node_modules/globals": {
+			"version": "16.5.0",
+			"resolved": "https://registry.npmjs.org/globals/-/globals-16.5.0.tgz",
+			"integrity": "sha512-c/c15i26VrJ4IRt5Z89DnIzCGDn9EcebibhAOjw5ibqEHsE1wLUgkPn9RDmNcUKyU87GeaL633nyJ+pplFR2ZQ==",
+			"dev": true,
+			"license": "MIT",
+			"engines": {
+				"node": ">=18"
+			},
+			"funding": {
+				"url": "https://github.com/sponsors/sindresorhus"
+			}
+		},
 		"node_modules/eslint-plugin-prettier": {
 			"version": "5.5.4",
 			"resolved": "https://registry.npmjs.org/eslint-plugin-prettier/-/eslint-plugin-prettier-5.5.4.tgz",
@@ -6075,9 +6088,9 @@
 			}
 		},
 		"node_modules/esquery": {
-			"version": "1.6.0",
-			"resolved": "https://registry.npmjs.org/esquery/-/esquery-1.6.0.tgz",
-			"integrity": "sha512-ca9pw9fomFcKPvFLXhBKUK90ZvGibiGOvRJNbjljY7s7uq/5YO4BOzcYtJqExdx99rF6aAcnRxHmcUHcz6sQsg==",
+			"version": "1.7.0",
+			"resolved": "https://registry.npmjs.org/esquery/-/esquery-1.7.0.tgz",
+			"integrity": "sha512-Ap6G0WQwcU/LHsvLwON1fAQX9Zp0A2Y6Y/cJBl9r/JbW90Zyg4/zbG6zzKa2OTALELarYHmKu0GhpM5EO+7T0g==",
 			"dev": true,
 			"license": "BSD-3-Clause",
 			"dependencies": {
@@ -6915,9 +6928,9 @@
 			}
 		},
 		"node_modules/globals": {
-			"version": "16.5.0",
-			"resolved": "https://registry.npmjs.org/globals/-/globals-16.5.0.tgz",
-			"integrity": "sha512-c/c15i26VrJ4IRt5Z89DnIzCGDn9EcebibhAOjw5ibqEHsE1wLUgkPn9RDmNcUKyU87GeaL633nyJ+pplFR2ZQ==",
+			"version": "17.0.0",
+			"resolved": "https://registry.npmjs.org/globals/-/globals-17.0.0.tgz",
+			"integrity": "sha512-gv5BeD2EssA793rlFWVPMMCqefTlpusw6/2TbAVMy0FzcG8wKJn4O+NqJ4+XWmmwrayJgw5TzrmWjFgmz1XPqw==",
 			"dev": true,
 			"license": "MIT",
 			"engines": {
@@ -8956,6 +8969,7 @@
 			"version": "3.1.1",
 			"resolved": "https://registry.npmjs.org/whatwg-encoding/-/whatwg-encoding-3.1.1.tgz",
 			"integrity": "sha512-6qN4hJdMwfYBtE3YBTTHhoeuUrDBPZmbQaxWAqSALV/MeEnR5z1xd8UKud2RAkFoPkmB+hli1TZSnyi84xz1vQ==",
+			"deprecated": "Use @exodus/bytes instead for a more spec-conformant and faster implementation",
 			"dev": true,
 			"license": "MIT",
 			"dependencies": {
@@ -9080,9 +9094,9 @@
 			}
 		},
 		"node_modules/katex": {
-			"version": "0.16.25",
-			"resolved": "https://registry.npmjs.org/katex/-/katex-0.16.25.tgz",
-			"integrity": "sha512-woHRUZ/iF23GBP1dkDQMh1QBad9dmr8/PAwNA54VrSOVYgI12MAcE14TqnDdQOdzyEonGzMepYnqBMYdsoAr8Q==",
+			"version": "0.16.27",
+			"resolved": "https://registry.npmjs.org/katex/-/katex-0.16.27.tgz",
+			"integrity": "sha512-aeQoDkuRWSqQN6nSvVCEFvfXdqo1OQiCmmW1kc9xSdjutPv7BGO7pqY9sQRJpMOGrEdfDgF2TfRXe5eUAD2Waw==",
 			"dev": true,
 			"funding": [
 				"https://opencollective.com/katex",
@@ -9127,9 +9141,9 @@
 			}
 		},
 		"node_modules/ky": {
-			"version": "1.14.0",
-			"resolved": "https://registry.npmjs.org/ky/-/ky-1.14.0.tgz",
-			"integrity": "sha512-Rczb6FMM6JT0lvrOlP5WUOCB7s9XKxzwgErzhKlKde1bEV90FXplV1o87fpt4PU/asJFiqjYJxAJyzJhcrxOsQ==",
+			"version": "1.14.2",
+			"resolved": "https://registry.npmjs.org/ky/-/ky-1.14.2.tgz",
+			"integrity": "sha512-q3RBbsO5A5zrPhB6CaCS8ZUv+NWCXv6JJT4Em0i264G9W0fdPB8YRfnnEi7Dm7X7omAkBIPojzYJ2D1oHTHqug==",
 			"dev": true,
 			"license": "MIT",
 			"engines": {
@@ -9469,9 +9483,9 @@
 			}
 		},
 		"node_modules/markdownlint": {
-			"version": "0.39.0",
-			"resolved": "https://registry.npmjs.org/markdownlint/-/markdownlint-0.39.0.tgz",
-			"integrity": "sha512-Xt/oY7bAiHwukL1iru2np5LIkhwD19Y7frlsiDILK62v3jucXCD6JXlZlwMG12HZOR+roHIVuJZrfCkOhp6k3g==",
+			"version": "0.40.0",
+			"resolved": "https://registry.npmjs.org/markdownlint/-/markdownlint-0.40.0.tgz",
+			"integrity": "sha512-UKybllYNheWac61Ia7T6fzuQNDZimFIpCg2w6hHjgV1Qu0w1TV0LlSgryUGzM0bkKQCBhy2FDhEELB73Kb0kAg==",
 			"dev": true,
 			"license": "MIT",
 			"dependencies": {
@@ -9482,7 +9496,8 @@
 				"micromark-extension-gfm-footnote": "2.1.0",
 				"micromark-extension-gfm-table": "2.1.1",
 				"micromark-extension-math": "3.1.0",
-				"micromark-util-types": "2.0.2"
+				"micromark-util-types": "2.0.2",
+				"string-width": "8.1.0"
 			},
 			"engines": {
 				"node": ">=20"
@@ -9492,9 +9507,9 @@
 			}
 		},
 		"node_modules/markdownlint-cli": {
-			"version": "0.46.0",
-			"resolved": "https://registry.npmjs.org/markdownlint-cli/-/markdownlint-cli-0.46.0.tgz",
-			"integrity": "sha512-4gxTNzPjpLnY7ftrEZD4flPY0QBkQLiqezb6KURFSkV+vPHFOsYw8OMtY6fu82Yt8ghtSrWegpYdq1ix25VFLQ==",
+			"version": "0.47.0",
+			"resolved": "https://registry.npmjs.org/markdownlint-cli/-/markdownlint-cli-0.47.0.tgz",
+			"integrity": "sha512-HOcxeKFAdDoldvoYDofd85vI8LgNWy8vmYpCwnlLV46PJcodmGzD7COSSBlhHwsfT4o9KrAStGodImVBus31Bg==",
 			"dev": true,
 			"license": "MIT",
 			"dependencies": {
@@ -9505,7 +9520,7 @@
 				"jsonc-parser": "~3.3.1",
 				"jsonpointer": "~5.0.1",
 				"markdown-it": "~14.1.0",
-				"markdownlint": "~0.39.0",
+				"markdownlint": "~0.40.0",
 				"minimatch": "~10.1.1",
 				"run-con": "~1.3.2",
 				"smol-toml": "~1.5.2",
@@ -9554,6 +9569,52 @@
 				"url": "https://github.com/sponsors/isaacs"
 			}
 		},
+		"node_modules/markdownlint/node_modules/ansi-regex": {
+			"version": "6.2.2",
+			"resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.2.2.tgz",
+			"integrity": "sha512-Bq3SmSpyFHaWjPk8If9yc6svM8c56dB5BAtW4Qbw5jHTwwXXcTLoRMkpDJp6VL0XzlWaCHTXrkFURMYmD0sLqg==",
+			"dev": true,
+			"license": "MIT",
+			"engines": {
+				"node": ">=12"
+			},
+			"funding": {
+				"url": "https://github.com/chalk/ansi-regex?sponsor=1"
+			}
+		},
+		"node_modules/markdownlint/node_modules/string-width": {
+			"version": "8.1.0",
+			"resolved": "https://registry.npmjs.org/string-width/-/string-width-8.1.0.tgz",
+			"integrity": "sha512-Kxl3KJGb/gxkaUMOjRsQ8IrXiGW75O4E3RPjFIINOVH8AMl2SQ/yWdTzWwF3FevIX9LcMAjJW+GRwAlAbTSXdg==",
+			"dev": true,
+			"license": "MIT",
+			"dependencies": {
+				"get-east-asian-width": "^1.3.0",
+				"strip-ansi": "^7.1.0"
+			},
+			"engines": {
+				"node": ">=20"
+			},
+			"funding": {
+				"url": "https://github.com/sponsors/sindresorhus"
+			}
+		},
+		"node_modules/markdownlint/node_modules/strip-ansi": {
+			"version": "7.1.2",
+			"resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.1.2.tgz",
+			"integrity": "sha512-gmBGslpoQJtgnMAvOVqGZpEz9dyoKTCzy2nfz/n8aIFhN/jCE/rCmcxabB6jOOHV+0WNnylOxaxBQPSvcWklhA==",
+			"dev": true,
+			"license": "MIT",
+			"dependencies": {
+				"ansi-regex": "^6.0.1"
+			},
+			"engines": {
+				"node": ">=12"
+			},
+			"funding": {
+				"url": "https://github.com/chalk/strip-ansi?sponsor=1"
+			}
+		},
 		"node_modules/math-intrinsics": {
 			"version": "1.1.0",
 			"resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
@@ -10369,9 +10430,9 @@
 			}
 		},
 		"node_modules/nwsapi": {
-			"version": "2.2.22",
-			"resolved": "https://registry.npmjs.org/nwsapi/-/nwsapi-2.2.22.tgz",
-			"integrity": "sha512-ujSMe1OWVn55euT1ihwCI1ZcAaAU3nxUiDwfDQldc51ZXaB9m2AyOn6/jh1BLe2t/G8xd6uKG1UBF2aZJeg2SQ==",
+			"version": "2.2.23",
+			"resolved": "https://registry.npmjs.org/nwsapi/-/nwsapi-2.2.23.tgz",
+			"integrity": "sha512-7wfH4sLbt4M0gCDzGE6vzQBo0bfTKjU7Sfpqy/7gs1qBfYz2vEJH6vXcBKpO3+6Yu1telwd0t9HpyOoLEQQbIQ==",
 			"dev": true,
 			"license": "MIT"
 		},
@@ -10939,9 +11000,9 @@
 			}
 		},
 		"node_modules/prettier": {
-			"version": "3.7.3",
-			"resolved": "https://registry.npmjs.org/prettier/-/prettier-3.7.3.tgz",
-			"integrity": "sha512-QgODejq9K3OzoBbuyobZlUhznP5SKwPqp+6Q6xw6o8gnhr4O85L2U915iM2IDcfF2NPXVaM9zlo9tdwipnYwzg==",
+			"version": "3.7.4",
+			"resolved": "https://registry.npmjs.org/prettier/-/prettier-3.7.4.tgz",
+			"integrity": "sha512-v6UNi1+3hSlVvv8fSaoUbggEM5VErKmmpGA7Pl3HF8V6uKY7rvClBOJlH6yNwQtfTueNkGVpOv/mtWL9L4bgRA==",
 			"dev": true,
 			"license": "MIT",
 			"peer": true,
@@ -10956,9 +11017,9 @@
 			}
 		},
 		"node_modules/prettier-linter-helpers": {
-			"version": "1.0.0",
-			"resolved": "https://registry.npmjs.org/prettier-linter-helpers/-/prettier-linter-helpers-1.0.0.tgz",
-			"integrity": "sha512-GbK2cP9nraSSUF9N2XwUwqfzlAFlMNYYl+ShE/V+H8a9uNl/oUqB1w2EL54Jh0OlyRSd8RfWYJ3coVS4TROP2w==",
+			"version": "1.0.1",
+			"resolved": "https://registry.npmjs.org/prettier-linter-helpers/-/prettier-linter-helpers-1.0.1.tgz",
+			"integrity": "sha512-SxToR7P8Y2lWmv/kTzVLC1t/GDI2WGjMwNhLLE9qtH8Q13C+aEmuRlzDst4Up4s0Wc8sF2M+J57iB3cMLqftfg==",
 			"dev": true,
 			"license": "MIT",
 			"dependencies": {
@@ -11114,9 +11175,9 @@
 			"license": "MIT"
 		},
 		"node_modules/qs": {
-			"version": "6.14.0",
-			"resolved": "https://registry.npmjs.org/qs/-/qs-6.14.0.tgz",
-			"integrity": "sha512-YWWTjgABSKcvs/nWBi9PycY/JiPJqOD4JA6o9Sej2AtvSGarXxKC3OQSk4pAarbdQlKAh5D4FCQkJNkW+GAn3w==",
+			"version": "6.14.1",
+			"resolved": "https://registry.npmjs.org/qs/-/qs-6.14.1.tgz",
+			"integrity": "sha512-4EK3+xJl8Ts67nLYNwqw/dsFVnCf+qR7RgXSK9jEEm9unao3njwMDdmsdvoKBKHzxd7tCYz5e5M+SnMjdtXGQQ==",
 			"dev": true,
 			"license": "BSD-3-Clause",
 			"dependencies": {
@@ -12507,9 +12568,9 @@
 			}
 		},
 		"node_modules/systeminformation": {
-			"version": "5.27.7",
-			"resolved": "https://registry.npmjs.org/systeminformation/-/systeminformation-5.27.7.tgz",
-			"integrity": "sha512-saaqOoVEEFaux4v0K8Q7caiauRwjXC4XbD2eH60dxHXbpKxQ8kH9Rf7Jh+nryKpOUSEFxtCdBlSUx0/lO6rwRg==",
+			"version": "5.29.1",
+			"resolved": "https://registry.npmjs.org/systeminformation/-/systeminformation-5.29.1.tgz",
+			"integrity": "sha512-bBroZc2we1tpgTBKZL7JguBdObC1OY+eXAoEBdsTp3utfcCa8+jUf+Wq/intTCJmiKJcuLEPsjCU6uMye0qvsQ==",
 			"dev": true,
 			"license": "MIT",
 			"os": [
@@ -13118,9 +13179,9 @@
 			}
 		},
 		"node_modules/update-browserslist-db": {
-			"version": "1.1.4",
-			"resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.1.4.tgz",
-			"integrity": "sha512-q0SPT4xyU84saUX+tomz1WLkxUbuaJnR1xWt17M7fJtEJigJeWUNGUqrauFXsHnqev9y9JTRGwk13tFBuKby4A==",
+			"version": "1.2.3",
+			"resolved": "https://registry.npmjs.org/update-browserslist-db/-/update-browserslist-db-1.2.3.tgz",
+			"integrity": "sha512-Js0m9cx+qOgDxo0eMiFGEueWztz+d4+M3rGlmKPT+T4IS/jP4ylw3Nwpu6cpTTP8R1MAC1kF4VbdLt3ARf209w==",
 			"dev": true,
 			"funding": [
 				{
@@ -13371,6 +13432,7 @@
 			"version": "2.0.0",
 			"resolved": "https://registry.npmjs.org/whatwg-encoding/-/whatwg-encoding-2.0.0.tgz",
 			"integrity": "sha512-p41ogyeMUrw3jWclHWTQg1k05DSVXPLcVxRTYsXUk+ZooOCZLcoYgPZ/HL/D/N+uQPOtcp1me1WhBEaX02mhWg==",
+			"deprecated": "Use @exodus/bytes instead for a more spec-conformant and faster implementation",
 			"dev": true,
 			"license": "MIT",
 			"dependencies": {
@@ -14222,9 +14284,9 @@
 			}
 		},
 		"node_modules/ws": {
-			"version": "8.18.3",
-			"resolved": "https://registry.npmjs.org/ws/-/ws-8.18.3.tgz",
-			"integrity": "sha512-PEIGCY5tSlUt50cqyMXfCzX+oOPqN0vuGqWzbcJ2xvnkzkq46oOpz7dQaTDBdfICb4N14+GARUDw2XV2N4tvzg==",
+			"version": "8.19.0",
+			"resolved": "https://registry.npmjs.org/ws/-/ws-8.19.0.tgz",
+			"integrity": "sha512-blAT2mjOEIi0ZzruJfIhb3nps74PRWTCz1IjglWEEpQl5XS/UNama6u2/rjFkDDouqr4L67ry+1aGIALViWjDg==",
 			"dev": true,
 			"license": "MIT",
 			"engines": {
diff --git a/package.json b/package.json
index 86c3d1c..88dcc3c 100644
--- a/package.json
+++ b/package.json
@@ -18,17 +18,17 @@
 	"description": "Small Dev Talk - Talk with the Developers of the Future! Find interviews, news articles and reviews on the latest in the indie scene.",
 	"main": "index.html",
 	"devDependencies": {
-		"cypress": "^15.7.1",
-		"eslint": "^9.39.1",
+		"cypress": "^15.8.1",
+		"eslint": "^9.39.2",
 		"eslint-config-prettier": "^10.1.8",
 		"eslint-plugin-cypress": "^5.2.0",
 		"eslint-plugin-prettier": "^5.5.4",
-		"globals": "^16.5.0",
+		"globals": "^17.0.0",
 		"http-server": "^14.1.1",
 		"jest": "^30.2.0",
 		"jest-environment-jsdom": "^30.2.0",
-		"markdownlint-cli": "^0.46.0",
-		"prettier": "^3.7.3",
+		"markdownlint-cli": "^0.47.0",
+		"prettier": "^3.7.4",
 		"start-server-and-test": "^2.1.3",
 		"workbox-cli": "^7.4.0"
 	},

From 7f6e4fc062f084e8e78026c26600d6d95a739844 Mon Sep 17 00:00:00 2001
From: Alexander Sullivan <alexander.joohyun.sullivan@gmail.com>
Date: Mon, 5 Jan 2026 22:19:43 -0500
Subject: [PATCH 2/2] update docs

---
 .markdownlint.json             |   1 +
 docs/api/article-filler.md     | 251 +++++++++++++++++++++++++++++++++
 docs/api/index.md              |  42 ++++++
 docs/architecture/data-flow.md | 236 +++++++++++++++++++++++++++++++
 docs/architecture/index.md     |  84 +++++++++++
 docs/architecture/system.md    | 205 +++++++++++++++++++++++++++
 docs/guide/articles.md         | 160 +++++++++++++++++++++
 docs/guide/deployment.md       |  15 ++
 docs/guide/getting-started.md  | 167 ++++++++++++++++++++++
 docs/guide/index.md            |  97 +++++++++++++
 docs/guide/testing.md          | 113 +++++++++++++++
 docs/index.md                  |  72 ++++++++++
 12 files changed, 1443 insertions(+)
 create mode 100644 docs/api/article-filler.md
 create mode 100644 docs/api/index.md
 create mode 100644 docs/architecture/data-flow.md
 create mode 100644 docs/architecture/index.md
 create mode 100644 docs/architecture/system.md
 create mode 100644 docs/guide/articles.md
 create mode 100644 docs/guide/deployment.md
 create mode 100644 docs/guide/getting-started.md
 create mode 100644 docs/guide/index.md
 create mode 100644 docs/guide/testing.md
 create mode 100644 docs/index.md

diff --git a/.markdownlint.json b/.markdownlint.json
index b528015..ee9a2d2 100644
--- a/.markdownlint.json
+++ b/.markdownlint.json
@@ -1,4 +1,5 @@
 {
+	"MD007": false,
 	"MD010": false,
 	"MD013": false,
 	"MD029": false,
diff --git a/docs/api/article-filler.md b/docs/api/article-filler.md
new file mode 100644
index 0000000..b252ac1
--- /dev/null
+++ b/docs/api/article-filler.md
@@ -0,0 +1,251 @@
+# ArticleFiller Class API Reference
+
+The `ArticleFiller` class is the core module responsible for managing article data, rendering content, and handling navigation in Small Dev Talk.
+
+**Location:** [src/scripts/index.js](../../src/scripts/index.js)
+
+**Type:** Singleton class (static methods only)
+
+**Dependencies:** Showdown.js, Sentry, fetch API
+
+## Overview
+
+ArticleFiller is a utility class that:
+
+- Fetches and caches article metadata from JSON
+- Loads article markdown content dynamically
+- Converts markdown to HTML using Showdown
+- Updates page metadata (title, description, image)
+- Handles errors and displays user-friendly messages
+- Manages UI state and navigation
+
+**Key Pattern:** All methods are static, creating a singleton-like interface. State is maintained in class properties.
+
+## State Properties
+
+ArticleFiller maintains these static class properties:
+
+```javascript
+ArticleFiller.articleData = {}; // All article metadata
+ArticleFiller.articleMd = ""; // Raw markdown of current article
+ArticleFiller.article = ""; // Rendered HTML content
+ArticleFiller.whatPageDisplay = ""; // Current view state
+ArticleFiller.errMsg = ""; // Error message for display
+```
+
+## Methods
+
+### `retrieveArticleData()`
+
+Fetches and caches the article metadata registry.
+
+**Signature:**
+
+```javascript
+static retrieveArticleData() // No parameters
+```
+
+**Behavior:**
+
+1. Fetches JSON from `/src/articleArchive/articleData.json`
+2. Stores result in `ArticleFiller.articleData`
+3. Logs to console for debugging
+4. Called once on page load (see [index.html](../../index.html) `onload` event)
+
+**Example:**
+
+```javascript
+ArticleFiller.retrieveArticleData();
+console.log(ArticleFiller.articleData);
+// { "Playsets": {...}, "Caravaneer2": {...}, ... }
+```
+
+**Error Handling:** If fetch fails, error is logged to Sentry.
+
+### `callArticle()`
+
+Determines what content to display based on URL query parameters.
+
+**Signature:**
+
+```javascript
+static callArticle() // No parameters
+```
+
+**Behavior:**
+
+1. Parses `document.URL` for query parameters
+2. Extracts article name from URL (e.g., `/?ArticleName`)
+3. Routes to appropriate display:
+    - Query parameter matches article: Load article
+    - No query parameter: Display index/landing page
+    - Invalid article name: Display error
+
+**URL Examples:**
+
+- `https://smalldevtalk.net/?Playsets` → Load "Playsets" article
+- `https://smalldevtalk.net/?Caravaneer2` → Load "Caravaneer 2" article
+- `https://smalldevtalk.net/` → Display index page
+
+**Called by:** Page load (via `onload` in index.html)
+
+### `grabArticle(articleName)`
+
+Loads a specific article from the archive.
+
+**Signature:**
+
+```javascript
+static grabArticle(articleName) // Parameter: string
+```
+
+**Parameters:**
+
+- `articleName` (string) — Article key matching `articleData.json` key
+
+**Behavior:**
+
+1. Normalizes article name (removes spaces, applies capitalization)
+2. Checks if article exists in `ArticleFiller.articleData`
+3. Fetches markdown file from `/src/articleArchive/author.../{articleName}/`
+4. Converts markdown to HTML via Showdown
+5. Updates page title and metadata
+6. Renders HTML to page
+
+**Example:**
+
+```javascript
+ArticleFiller.grabArticle("Playsets");
+// Loads and renders the Playsets article
+```
+
+**Error Handling:**
+
+- If article not found: displays error via `displayError()`
+- If markdown file missing: shows 404 error
+- If markdown parsing fails: shows parsing error
+
+### `updateMetaData(articleData, articleKey)`
+
+Updates HTML `<meta>` tags for SEO and social sharing.
+
+**Signature:**
+
+```javascript
+static updateMetaData(articleData, articleKey) // Parameters: Object, string
+```
+
+**Parameters:**
+
+- `articleData` (Object) — Metadata object from articleData.json
+    - `title` — Article title
+    - `summary` — Brief description
+    - `author` — Author name
+    - `date` — Publication date (YYYY-MM-DD)
+    - `thumbnail` — Image filename
+- `articleKey` (string) — Article ID from URL
+
+**Updated Meta Tags:**
+
+```javascript
+document.title = articleData.title;
+// <meta name="description" content="...">
+// <meta property="og:title" content="...">
+// <meta property="og:description" content="...">
+// <meta property="og:image" content="...">
+// <meta name="twitter:title" content="...">
+// <meta name="twitter:description" content="...">
+// <meta name="twitter:image" content="...">
+```
+
+**Called by:** `grabArticle()` after loading article content
+
+### `addToPage()`
+
+Renders article HTML to the page.
+
+**Signature:**
+
+```javascript
+static addToPage() // No parameters
+```
+
+**Behavior:**
+
+1. Converts markdown to HTML using Showdown
+2. Inserts HTML into page DOM
+3. Updates page state (`whatPageDisplay`)
+4. Logs to Sentry for monitoring
+
+**Called by:** `grabArticle()` after metadata update
+
+### `displayError(msg)`
+
+Shows error messages to users.
+
+**Signature:**
+
+```javascript
+static displayError(msg) // Parameter: string
+```
+
+**Parameters:**
+
+- `msg` (string) — Error message to display
+
+**Behavior:**
+
+1. Logs error to console
+2. Sends error to Sentry
+3. Displays user-friendly error UI
+4. Stores error message in `ArticleFiller.errMsg`
+
+**Example:**
+
+```javascript
+ArticleFiller.displayError("Article not found");
+```
+
+## State Diagram
+
+ArticleFiller transitions through these states:
+
+```mermaid
+graph TD
+    A["Page Load"] -->|retrieveArticleData| B["Metadata Ready"]
+    B -->|callArticle| C{"Valid Article?"}
+    C -->|Yes| D["grabArticle"]
+    C -->|No| E["Display Index"]
+    D -->|Find Markdown| F["updateMetaData"]
+    F -->|Convert HTML| G["addToPage"]
+    G -->|Render| H["Article Displayed"]
+    D -->|Not Found| I["displayError"]
+    I --> J["Error Displayed"]
+```
+
+## Usage Examples
+
+### Load Article on Page Load
+
+```javascript
+// Called by index.html onload event
+ArticleFiller.retrieveArticleData();
+ArticleFiller.callArticle();
+```
+
+### Programmatically Load Article
+
+```javascript
+ArticleFiller.grabArticle("Playsets");
+// Article content now rendered to page
+```
+
+### Handle Errors
+
+```javascript
+try {
+	ArticleFiller.grabArticle("InvalidArticle");
+} catch (error) {
+	ArticleFiller.displayError(`Failed to load article: ${error.message}`);
+}
+```
diff --git a/docs/api/index.md b/docs/api/index.md
new file mode 100644
index 0000000..b1cda7a
--- /dev/null
+++ b/docs/api/index.md
@@ -0,0 +1,42 @@
+# API Reference
+
+This section provides detailed API documentation for the core modules and integrations in Small Dev Talk.
+
+## Overview
+
+The API reference documents the internal structure, method signatures, and usage patterns for the key components that power Small Dev Talk. Each document includes practical examples, parameter descriptions, and integration guidelines.
+
+## Available Documentation
+
+### [ArticleFiller Class](./article-filler.md)
+
+The core module responsible for managing article data, rendering content, and handling navigation.
+
+**Key Topics:**
+
+- State management and class properties
+- Article metadata retrieval
+- Dynamic content loading and rendering
+- Markdown to HTML conversion
+- Error handling and user feedback
+- URL parameter parsing and routing
+
+**Use this when:** You need to understand how articles are loaded, rendered, or displayed on the site.
+
+## Quick Reference
+
+### ArticleFiller Core Methods
+
+```javascript
+ArticleFiller.retrieveArticleData(); // Fetch article metadata
+ArticleFiller.callArticle(); // Route to appropriate display
+ArticleFiller.grabArticle(articleName); // Load specific article
+ArticleFiller.updateMetaData(data, key); // Update page metadata
+ArticleFiller.displayError(msg); // Show error to user
+```
+
+## Related Documentation
+
+- [System Architecture](../architecture/system.md) — High-level system design
+- [Data Flow](../architecture/data-flow.md) — How data moves through the application
+- [Getting Started Guide](../guide/getting-started.md) — Local development setup
diff --git a/docs/architecture/data-flow.md b/docs/architecture/data-flow.md
new file mode 100644
index 0000000..6a9b0cd
--- /dev/null
+++ b/docs/architecture/data-flow.md
@@ -0,0 +1,236 @@
+# Data Flow Diagram
+
+This document illustrates how data flows through Small Dev Talk from initial page load to rendered article.
+
+## Complete Data Flow
+
+```mermaid
+flowchart TD
+    subgraph Request["User Request"]
+        A1["User visits index.html<br/>or clicks article link"]
+        A2["URL contains query parameter<br/>?ArticleName"]
+    end
+
+    subgraph Init["Initialization"]
+        B1["Scripts load:<br/>jQuery, Showdown,<br/>Bootstrap, Sentry"]
+        B2["Sentry error tracking<br/>is configured"]
+        B3["Service worker<br/>registers if offline<br/>caching enabled"]
+    end
+
+    subgraph Metadata["Load Metadata"]
+        C1["ArticleFiller.retrieveArticleData()<br/>called"]
+        C2["Fetch /src/articleArchive/<br/>articleData.json"]
+        C3["Store JSON in memory<br/>ArticleFiller.articleData"]
+    end
+
+    subgraph Decision["Process URL & Decide"]
+        D1["ArticleFiller.callArticle()<br/>parses URL query"]
+        D2{"Article Name<br/>requested?"}
+        D3["Show homepage<br/>with grid"]
+        D4["Load single article"]
+    end
+
+    subgraph Fetch["Fetch Article Content"]
+        E1["Construct article path:<br/>authorAuthorName/<br/>YYYY-MM-DD_Title/<br/>Title.md"]
+        E2["Fetch markdown file<br/>from CDN or cache"]
+        E3["Store raw markdown<br/>ArticleFiller.articleMd"]
+    end
+
+    subgraph Meta["Update Page Metadata"]
+        F1["ArticleFiller.updateMetaData()<br/>updates page tags"]
+        F2["Document.title<br/>og:title<br/>og:description<br/>og:image"]
+        F3["Structured data<br/>application/ld+json"]
+    end
+
+    subgraph Render["Render HTML"]
+        G1["Showdown.Converter<br/>converts markdown → HTML"]
+        G2["Store rendered HTML<br/>ArticleFiller.article"]
+        G3["Inject HTML into<br/>#articleBody"]
+        G4["Remove #featuredArticles<br/>and #displayArticles"]
+    end
+
+    subgraph Cache["Cache & Service Worker"]
+        H1["Service Worker<br/>precaches article assets"]
+        H2["Images, CSS, JS<br/>stored in cache"]
+        H3["Subsequent visits<br/>load from cache first"]
+    end
+
+    subgraph Monitor["Error Tracking"]
+        I1["Sentry monitors for<br/>fetch errors"]
+        I2["Console errors logged<br/>via enableLogs: true"]
+        I3["Network errors reported<br/>with context"]
+    end
+
+    subgraph Display["Display to User"]
+        J1["Rendered article<br/>visible in browser"]
+        J2["Images lazy-load<br/>from article directory"]
+        J3["Bootstrap styling<br/>applied"]
+    end
+
+    A1 --> A2
+    A2 --> B1
+    B1 --> B2
+    B2 --> B3
+    B3 --> C1
+    C1 --> C2
+    C2 --> C3
+    C3 --> D1
+    D1 --> D2
+    D2 -->|No| D3
+    D2 -->|Yes| D4
+    D4 --> E1
+    E1 --> E2
+    E2 --> E3
+    E3 --> F1
+    F1 --> F2
+    F2 --> F3
+    F3 --> G1
+    G1 --> G2
+    G2 --> G3
+    G3 --> H1
+    G3 --> I1
+    H1 --> H2
+    H2 --> H3
+    I1 --> I2
+    I2 --> I3
+    G3 --> J1
+    J1 --> J2
+    J2 --> J3
+```
+
+## Component Interactions
+
+### 1. Bootstrap & Resource Loading
+
+When [index.html](../../index.html) loads:
+
+1. HTML is parsed
+2. External scripts and stylesheets are downloaded:
+    - Bootstrap CSS (from CDN)
+    - jQuery (from CDN)
+    - Showdown.js (from CDN)
+    - Sentry SDK (from sentry-cdn.com)
+    - Custom [index.js](../../src/scripts/index.js) (local)
+
+3. Inline `<script>` block initializes:
+    - `Sentry.init()` with configuration
+    - `Sentry.configureScope()` with user context
+    - `ArticleFiller.retrieveArticleData()` to start loading metadata
+
+### 2. Article Data Retrieval
+
+```mermaid
+sequenceDiagram
+    participant Browser
+    participant AF as ArticleFiller
+    participant Server
+
+    Browser->>AF: Page load complete
+    AF->>Server: GET /src/articleArchive/articleData.json
+    Server-->>AF: JSON with article metadata
+    AF->>AF: Store in articleData static property
+    AF->>AF: Call callArticle()
+```
+
+### 3. Article Loading Logic
+
+The `callArticle()` method determines what to display:
+
+```mermaid
+flowchart TD
+    A["callArticle()"] --> B{"URL has<br/>query string?"}
+    B -->|No query| C["callDisplay()<br/>Show homepage"]
+    B -->|Has query| D["Parse article name<br/>from query"]
+    D --> E{"Single article<br/>or multiple?"}
+    E -->|Multiple params| C
+    E -->|Single article| F["grabArticle<br/>articleName"]
+    F --> G["Hide#featuredArticles<br/>Hide #displayArticles<br/>Show #articleBody"]
+    G --> H["Fetch article markdown<br/>from archive"]
+    H --> I["Convert to HTML<br/>with Showdown"]
+    I --> J["updateMetaData<br/>update page tags"]
+    J --> K["Render HTML<br/>to #articleBody"]
+```
+
+### 4. Error Handling Flow
+
+```mermaid
+flowchart TD
+    A["Fetch article"] -->|Success| B["Parse & render"]
+    A -->|Fetch fails| C["displayError<br/>Log to console"]
+    A -->|Invalid article| C
+    B -->|Parse error| C
+    C --> D["Sentry.captureException<br/>or console.error"]
+    D --> E["Show error UI<br/>with refresh button"]
+    E --> F["User can return<br/>to homepage"]
+```
+
+### 5. Metadata Update Sequence
+
+When an article loads, the following metadata is dynamically updated:
+
+```javascript
+// 1. Document title
+document.title = `${articleData.title} | Small Dev Talk`
+
+// 2. Open Graph tags
+og:title → article title
+og:description → article summary
+og:image → article thumbnail
+
+// 3. Twitter Card tags
+twitter:title → article title
+twitter:description → article summary
+twitter:image → article thumbnail
+
+// 4. Structured data (Schema.org)
+{
+  "@type": "NewsArticle",
+  "headline": article title,
+  "description": article summary,
+  "image": article thumbnail,
+  "author": article author,
+  "datePublished": article date
+}
+```
+
+## State Transitions
+
+ArticleFiller maintains state through static properties:
+
+```mermaid
+stateDiagram-v2
+    [*] --> Uninitialized
+    Uninitialized --> MetadataLoaded: retrieveArticleData()<br/>completes
+    MetadataLoaded --> DisplayingHome: callArticle()<br/>no query
+    MetadataLoaded --> FetchingArticle: grabArticle()<br/>called
+    FetchingArticle --> RenderingArticle: Markdown fetched
+    RenderingArticle --> DisplayingArticle: HTML injected
+    DisplayingArticle --> FetchingArticle: User clicks article
+    DisplayingHome --> FetchingArticle: User clicks article
+    FetchingArticle --> ErrorState: Fetch fails
+    ErrorState --> DisplayingHome: User clicks home
+    ErrorState --> FetchingArticle: User retries
+
+    note right of MetadataLoaded
+        articleData populated
+        Ready for navigation
+    end note
+
+    note right of RenderingArticle
+        Showdown converting
+        Metadata updating
+    end note
+
+    note right of DisplayingArticle
+        Article visible
+        Ready for interaction
+    end note
+```
+
+---
+
+See also:
+
+- [System Architecture](./system.md)
+- [Dependencies & Integrations](./dependencies.md)
+- [ArticleFiller API](../api/article-filler.md)
diff --git a/docs/architecture/index.md b/docs/architecture/index.md
new file mode 100644
index 0000000..620b175
--- /dev/null
+++ b/docs/architecture/index.md
@@ -0,0 +1,84 @@
+# Architecture Documentation
+
+This section explains the system design, data flows, and architectural decisions that shape Small Dev Talk.
+
+## Overview
+
+The architecture documentation provides a comprehensive understanding of how Small Dev Talk is structured, how components interact, and why specific design decisions were made. This is essential reading for anyone working on the codebase or planning significant changes.
+
+## Available Documentation
+
+### [System Architecture](./system.md)
+
+Complete overview of the system design and component interactions.
+
+**Key Topics:**
+
+- High-level architecture diagram
+- Component breakdown (Client Layer, Core Logic, Data Layer, Services)
+- ArticleFiller singleton pattern
+- Article metadata registry
+- Service Worker and caching strategy
+- Security and Content Security Policy (CSP)
+- Navigation structure
+- Technology stack and dependencies
+
+### [Data Flow](./data-flow.md)
+
+Detailed explanation of how data moves through the application from page load to rendered content.
+
+**Key Topics:**
+
+- Complete data flow sequence diagrams
+- Page initialization lifecycle
+- Article loading process
+- Metadata update flow
+- Error handling workflows
+- Component interaction sequences
+- State transitions
+
+## Architectural Principles
+
+Small Dev Talk follows these core architectural principles:
+
+1. **Static-First Architecture** — No server-side processing; all content served as static files
+2. **Client-Side Rendering** — Markdown converted to HTML in the browser using Showdown.js
+3. **Metadata-Driven** — All articles indexed in a central JSON registry
+4. **Progressive Enhancement** — Service Workers provide offline capability
+5. **Security-First** — Strict Content Security Policy (CSP) headers
+6. **Maintainability** — Project in maintenance mode, focusing on stability over features
+
+## System Diagrams
+
+### High-Level Architecture
+
+```mermaid
+graph TB
+    User[User Browser]
+    HTML[index.html]
+    AF[ArticleFiller Class]
+    Meta[articleData.json]
+    Archive[Article Archive]
+    SW[Service Worker]
+    Sentry[Sentry Monitoring]
+
+    User --> HTML
+    HTML --> AF
+    AF --> Meta
+    AF --> Archive
+    HTML --> SW
+    AF --> Sentry
+```
+
+### Component Layers
+
+- **Client Layer:** HTML, CSS, Bootstrap UI
+- **Core Logic:** ArticleFiller (singleton class)
+- **Data Layer:** articleData.json, markdown files
+- **Services:** Service Worker, Sentry monitoring
+
+## Related Documentation
+
+- [ArticleFiller API](../api/article-filler.md) — Core class implementation details
+- [Getting Started Guide](../guide/getting-started.md) — Local development setup
+- [Deployment Guide](../guide/deployment.md) — Build and deployment process
diff --git a/docs/architecture/system.md b/docs/architecture/system.md
new file mode 100644
index 0000000..d09cd73
--- /dev/null
+++ b/docs/architecture/system.md
@@ -0,0 +1,205 @@
+# System Architecture
+
+Small Dev Talk is a client-side static web application that loads article metadata and content on-demand. The architecture prioritizes offline availability through service workers and progressive caching.
+
+## Architecture Overview
+
+```mermaid
+graph TB
+    subgraph Client["Browser / Client Layer"]
+        HTML["index.html<br/>Entry Point"]
+        CSS["CSS Stylesheets<br/>style.css, Bootstrap"]
+        JS["JavaScript Runtime"]
+    end
+
+    subgraph Core["Core Application"]
+        AF["ArticleFiller<br/>Article Loading & Rendering"]
+        AF_subA["retrieveArticleData()"]
+        AF_subB["grabArticle()"]
+        AF_subC["updateMetaData()"]
+    end
+
+    subgraph Data["Data & Assets"]
+        ArticleData["articleData.json<br/>Metadata"]
+        ArticleArchive["Article Archive<br/>Markdown Files"]
+        Images["Images & Assets"]
+    end
+
+    subgraph Services["External Services & Features"]
+        Sentry["Sentry v10.32.1<br/>Error Tracking"]
+        SW["Service Worker<br/>Offline Caching"]
+        Analytics["Analytics<br/>GA + Cloudflare"]
+    end
+
+    subgraph Libraries["UI Libraries"]
+        Bootstrap["Bootstrap v5<br/>Styling & Components"]
+        Showdown["Showdown.js<br/>Markdown Parser"]
+        jQuery["jQuery<br/>DOM Utilities"]
+    end
+
+    HTML -->|loads| CSS
+    HTML -->|loads| JS
+    JS -->|initializes| AF
+    AF -->|fetches| ArticleData
+    AF -->|fetches| ArticleArchive
+    AF -->|renders with| Showdown
+    AF -->|updates| HTML
+    AF -->|reports errors| Sentry
+    SW -->|caches| Images
+    SW -->|caches| ArticleArchive
+    JS -->|styles with| Bootstrap
+    AF -->|updates meta| Analytics
+```
+
+## Core Components
+
+### 1. Application Entry Point: [index.html](../../index.html)
+
+The single HTML document that serves as the application shell. Key responsibilities:
+
+- Meta tag configuration (SEO, Open Graph, Twitter Card, security headers)
+- Script and stylesheet loading
+- DOM structure with placeholders for dynamic content:
+    - `#featuredArticles` — Homepage featured articles section
+    - `#displayArticles` — Full article grid
+    - `#articleBody` — Individual article container
+- Sentry initialization and error tracking setup
+- Service worker registration
+
+### 2. Core Logic: [ArticleFiller Class](./../../src/scripts/index.js)
+
+The `ArticleFiller` class is the central orchestrator for loading, rendering, and displaying articles. See [ArticleFiller API documentation](../api/article-filler.md) for detailed method signatures.
+
+**Key Responsibilities:**
+
+- **Data Retrieval:** Fetches `articleData.json` to build the article registry
+- **Article Loading:** Retrieves markdown files based on article name and author
+- **Rendering:** Converts markdown to HTML using Showdown.js
+- **Meta Tagging:** Dynamically updates page title, Open Graph, Twitter Card, and structured data
+- **Error Handling:** Displays user-friendly error messages when content fails to load
+
+**State Management:**
+
+Static class properties maintain:
+
+- `articleData` — Complete article metadata registry
+- `articleMd` — Raw markdown content of the current article
+- `article` — Rendered HTML content
+- `whatPageDisplay` — Current view state (e.g., "index", article name)
+- `errMsg` — Error message display
+
+### 3. Data Layer: [Article Metadata](../../src/articleArchive/articleData.json)
+
+A JSON file containing metadata for all published articles:
+
+```json
+{
+	"ArticleTitle": {
+		"title": "Full Article Title",
+		"summary": "Brief description",
+		"author": "Author Name",
+		"date": "YYYY-MM-DD",
+		"thumbnail": "filename.jpg"
+	}
+}
+```
+
+**Metadata Fields:**
+
+| Field       | Type   | Required | Description                               |
+| ----------- | ------ | -------- | ----------------------------------------- |
+| `title`     | string | Yes      | Display title for the article             |
+| `summary`   | string | No       | Brief summary for listings                |
+| `author`    | string | Yes      | Author name (must match folder structure) |
+| `date`      | string | Yes      | Publication date (YYYY-MM-DD format)      |
+| `thumbnail` | string | No       | Filename of the thumbnail image           |
+
+### 4. Article Storage: [Archive Directory](../../src/articleArchive/)
+
+Directory structure follows a consistent pattern organized by author:
+
+```text
+src/articleArchive/
+├── articleData.json
+├── authorAlexanderSullivan/
+│   ├── YYYY-MM-DD_ArticleTitle/
+│   │   ├── ArticleTitle.md
+│   │   ├── image1.jpg
+│   │   ├── image2.jpg
+│   │   └── ...
+│   └── ...
+├── authorJeffCen/
+│   └── ...
+└── authorNeilRampone/
+    └── ...
+```
+
+**Important:** The key name in `articleData.json` must match the folder name exactly (case-sensitive, no spaces).
+
+### 5. Service Worker & Caching: [Service Worker Module](../../src/serviceWorker/sw.js)
+
+Managed by Workbox, the service worker provides:
+
+- **Precaching:** Articles, images, and assets are cached on first load
+- **Cache-First Strategy:** Images use cache-first approach with 10-item limit
+- **Offline Support:** Users can browse cached articles without internet
+- **Updated via:** [workbox-config.js](../../workbox-config.js)
+
+**Note:** Service workers are regenerated during build via the `npm run workbox` script.
+
+### 6. Error Tracking: [Sentry Integration](../../index.html#L122-L145)
+
+Sentry v10.32.1 is integrated for production error monitoring:
+
+- **Configuration:**
+    - DSN: Sentry project DSN (configured in index.html)
+    - Tracing enabled (1.0 sample rate in development)
+    - Session replay: 10% of sessions, 100% of error sessions
+    - Console error capture: Enabled via `enableLogs: true`
+
+- **Behavior:** Errors are captured and sent to Sentry for analysis and alerting
+
+See [Sentry Integration](../api/sentry.md) for configuration details.
+
+## Data Flow: Article Loading
+
+```mermaid
+sequenceDiagram
+    participant Browser
+    participant AF as ArticleFiller
+    participant JSON as articleData.json
+    participant API as Article File
+    participant Showdown
+
+    Browser->>AF: Page loads, calls retrieveArticleData()
+    AF->>JSON: Fetch metadata
+    JSON-->>AF: Return article registry
+    AF->>AF: callArticle() checks URL query string
+    alt Article Requested
+        AF->>API: Fetch YYYY-MM-DD_Title/Title.md
+        API-->>AF: Return markdown content
+        AF->>Showdown: Convert markdown to HTML
+        Showdown-->>AF: Return HTML
+        AF->>AF: updateMetaData() updates page tags
+        AF->>Browser: Render article HTML
+    else Homepage
+        AF->>Browser: Render article grid
+    end
+```
+
+## Navigation & URL Structure
+
+Small Dev Talk uses **URL query parameters** for client-side navigation:
+
+| URL                          | Purpose                         |
+| ---------------------------- | ------------------------------- |
+| `/?` or `/index.html`        | Homepage with article grid      |
+| `/?ArticleTitle`             | Display single article          |
+| `/?ArticleTitle&param=value` | (Additional parameters ignored) |
+
+**Example:**
+
+- `smalldevtalk.net/?Playsets` → Loads the "Playsets" article
+- `smalldevtalk.net/?Caravaneer2` → Loads the "Caravaneer 2" article
+
+Article names in the URL are converted to match the key in `articleData.json` (spaces removed, capitalized).
diff --git a/docs/guide/articles.md b/docs/guide/articles.md
new file mode 100644
index 0000000..6604219
--- /dev/null
+++ b/docs/guide/articles.md
@@ -0,0 +1,160 @@
+# Adding & Publishing Articles
+
+This guide explains how to add new articles to Small Dev Talk.
+
+## Article Directory Structure
+
+Articles are organized by author in the [articleArchive](../../src/articleArchive/) directory:
+
+```text
+src/articleArchive/
+├── authorName/
+│   └── YYYY-MM-DD_ArticleTitle/
+│       ├── ArticleTitle.md
+│       ├── image1.jpg
+│       ├── image2.jpg
+│       └── ...
+```
+
+## Step 1: Register Article Metadata
+
+Edit [src/articleArchive/articleData.json](../../src/articleArchive/articleData.json) and add:
+
+```json
+{
+	"NewArticleTitle": {
+		"title": "Full Article Title",
+		"summary": "Brief 1-2 sentence summary",
+		"author": "Author Name",
+		"date": "YYYY-MM-DD",
+		"thumbnail": "image1.jpg"
+	}
+}
+```
+
+**Field Requirements:**
+
+- `title`: Display title (required)
+- `author`: Must match author folder name (required)
+- `date`: Publication date in YYYY-MM-DD format (required)
+- `summary`: Brief description (optional)
+- `thumbnail`: Filename of cover image (optional)
+
+## Step 2: Create Article Directory
+
+Create the directory structure using the exact naming pattern:
+
+```bash
+mkdir -p src/articleArchive/author{AuthorFirstNameLastName}/{YYYY-MM-DD}_{ArticleTitle}/
+```
+
+**Example:**
+
+```bash
+mkdir -p src/articleArchive/authorAlexanderSullivan/2013-03-26_Caravaneer2/
+```
+
+## Step 3: Create Markdown File
+
+Create `ArticleTitle.md` in the article directory with content:
+
+```markdown
+# Article Title
+
+Article content in markdown format.
+
+## Section Heading
+
+More content here with **bold** and _italic_ text.
+
+### Subsection
+
+![Image Alt Text](image1.jpg)
+
+- Bullet list item 1
+- Bullet list item 2
+
+1. Numbered item 1
+2. Numbered item 2
+```
+
+**File Name:** Must match the key in `articleData.json` exactly
+
+## Step 4: Add Images
+
+Place all images in the article directory:
+
+```text
+src/articleArchive/authorAlexanderSullivan/2013-03-26_Caravaneer2/
+├── Caravaneer2.md
+├── image1.jpg
+├── image2.jpg
+├── image3.png
+└── ...
+```
+
+**Supported Formats:**
+
+- JPEG (.jpg, .jpeg)
+- PNG (.png)
+- WebP (.webp)
+- GIF (.gif)
+
+## Step 5: Update Service Worker Cache
+
+Rebuild the service worker to include new assets:
+
+```bash
+npm run workbox
+```
+
+This regenerates [src/serviceWorker/sw.js](../../src/serviceWorker/sw.js) with new article assets.
+
+## Step 6: Test Locally
+
+Start the dev server and verify:
+
+```bash
+npm run start
+```
+
+Access `http://localhost:3000/?ArticleTitle` and verify:
+
+- Article loads correctly
+- Images display
+- Metadata tags are correct (open DevTools)
+- No console errors
+
+## Step 7: Run Validation
+
+Run the full validation suite:
+
+```bash
+npm run validate
+```
+
+This ensures:
+
+- Code quality (ESLint)
+- Formatting (Prettier)
+- Tests pass
+- E2E tests pass
+- Markdown valid
+
+## Publishing
+
+Once validated locally:
+
+1. Commit changes to a feature branch
+2. Create a pull request
+3. Request review
+4. Merge to master
+5. GitHub Actions automatically builds and deploys
+
+---
+
+See also:
+
+- [System Architecture](../architecture/system.md)
+- [Getting Started Guide](./getting-started.md)
+- [Testing Guide](./testing.md)
diff --git a/docs/guide/deployment.md b/docs/guide/deployment.md
new file mode 100644
index 0000000..2f6a861
--- /dev/null
+++ b/docs/guide/deployment.md
@@ -0,0 +1,15 @@
+# Deployment & Build
+
+This guide explains the Small Dev Talk build process and deployment strategy.
+
+Small Dev Talk is a static site deployed on GitHub Pages.
+
+## GitHub Pages Deployment
+
+When PR is merged to `master`:
+
+1. GitHub Actions automatically:
+    - Runs `npm run validate`
+    - Runs `npm run build`
+    - Deploys to `gh-pages` branch
+    - Updates live site at [Small Dev Talk](https://smalldevtalk.net/)
diff --git a/docs/guide/getting-started.md b/docs/guide/getting-started.md
new file mode 100644
index 0000000..ec4379d
--- /dev/null
+++ b/docs/guide/getting-started.md
@@ -0,0 +1,167 @@
+# Getting Started Guide
+
+Welcome to the Small Dev Talk development environment. This guide covers installation, configuration, and running the project locally.
+
+## System Requirements
+
+- **Node.js:** v18+ (for npm and development tools)
+- **npm:** v8+
+- **Browser:** Chrome, Firefox, Safari, or Edge (recent versions)
+- **macOS/Linux/Windows:** All supported with appropriate shell environment
+
+## Installation
+
+### 1. Clone the Repository
+
+```bash
+git clone https://github.com/AlexJSully/Small-Dev-Talk.git
+cd Small-Dev-Talk
+```
+
+### 2. Install Dependencies
+
+```bash
+npm install
+```
+
+This installs all devDependencies from [package.json](../../package.json), including:
+
+- Testing frameworks (Jest, Cypress)
+- Code quality tools (ESLint, Prettier, Markdownlint)
+- Build tools (Workbox, http-server)
+
+## Local Development
+
+### Start the Development Server
+
+```bash
+npm run start
+```
+
+**What it does:**
+
+- Starts an HTTP server on `http://localhost:3000`
+- Serves all files from the project root
+- Allows browser access to the site with live reload capabilities
+
+**Access:** Open `http://localhost:3000` in your browser
+
+### Environment
+
+The local server will run with:
+
+- No authentication required
+- All articles loaded from the local archive
+- Sentry tracing enabled (data sent to Sentry project)
+- Service workers active (caching enabled)
+
+## Project Structure
+
+Key directories for development:
+
+```text
+Small-Dev-Talk/
+├── src/                          # Source files
+│   ├── scripts/
+│   │   ├── index.js             # Main application logic (ArticleFiller class)
+│   │   ├── index.test.js        # Unit tests for index.js
+│   │   └── libraries/           # Third-party libraries
+│   ├── articleArchive/
+│   │   ├── articleData.json     # Article metadata registry
+│   │   ├── authorAlexanderSullivan/
+│   │   ├── authorJeffCen/
+│   │   └── authorNeilRampone/
+│   ├── serviceWorker/           # Service worker configuration
+│   ├── style.css                # Main stylesheet
+│   └── icon/                    # App icons and manifest
+├── docs/                        # Documentation (this directory)
+├── cypress/                     # E2E tests
+├── index.html                   # Main HTML file
+├── package.json                 # Project metadata & dependencies
+├── eslint.config.js             # ESLint configuration
+├── .prettierrc                  # Prettier configuration
+├── .markdownlint.json           # Markdown linter configuration
+└── workbox-config.js            # Service worker precaching configuration
+```
+
+See [System Architecture](../architecture/system.md) for detailed information about each component.
+
+## Configuration Files
+
+### ESLint Configuration
+
+File: [eslint.config.js](../../eslint.config.js)
+
+Enforces code quality and style consistency across JavaScript files.
+
+```bash
+npm run eslint              # Run with auto-fix
+npm run eslint:check        # Check without fixing
+```
+
+### Prettier Configuration
+
+File: [.prettierrc](../../.prettierrc)
+
+Formats code consistently across the project.
+
+```bash
+npm run prettier            # Format all files
+npm run prettier:check      # Check formatting
+```
+
+### Markdown Linting
+
+File: [.markdownlint.json](../../.markdownlint.json)
+
+Ensures markdown files follow consistent formatting standards.
+
+```bash
+npm run lint:markdown       # Lint all markdown files
+```
+
+## Common Development Tasks
+
+### Adding an Article
+
+See [Adding & Publishing Articles](./articles.md) for detailed instructions.
+
+### Running Tests
+
+```bash
+npm run test                # Run all Jest unit tests
+npm run test:verbose        # Run with verbose output
+npm run cypress             # Open Cypress E2E test runner
+npm run e2e:headless        # Run E2E tests in headless mode
+```
+
+### Code Quality Checks
+
+```bash
+npm run validate            # Run full validation pipeline:
+                            # - prettier
+                            # - eslint
+                            # - jest
+                            # - e2e tests
+                            # - markdownlint
+```
+
+### Rebuilding Service Worker
+
+```bash
+npm run workbox             # Generate precaching manifest for service worker
+```
+
+This is needed after:
+
+- Adding new images or assets
+- Modifying build structure
+- Updating offline caching strategy
+
+## Environment Variables
+
+Currently, Small Dev Talk does not use environment variables. Configuration is primarily done through:
+
+- [index.html](../../index.html) — Sentry DSN, meta tags, security policies
+- [package.json](../../package.json) — Version number
+- [workbox-config.js](../../workbox-config.js) — Precaching configuration
diff --git a/docs/guide/index.md b/docs/guide/index.md
new file mode 100644
index 0000000..a55e1e3
--- /dev/null
+++ b/docs/guide/index.md
@@ -0,0 +1,97 @@
+# Developer Guides
+
+This section contains practical guides for developers working with the Small Dev Talk codebase.
+
+## Overview
+
+The developer guides provide step-by-step instructions for common tasks, from setting up your local environment to publishing new articles and deploying to production. These guides are designed for both internal maintainers and external contributors.
+
+## Available Guides
+
+### [Getting Started](./getting-started.md)
+
+Complete setup guide for local development.
+
+**What you'll learn:**
+
+- Installing dependencies
+- Running the local development server
+- Understanding the project structure
+- Configuring development tools (ESLint, Prettier, Markdownlint)
+- Debugging with browser DevTools
+- Working with Service Workers
+- Common troubleshooting steps
+
+### [Adding & Publishing Articles](./articles.md)
+
+Step-by-step guide for adding new articles to Small Dev Talk.
+
+**What you'll learn:**
+
+- Article directory structure requirements
+- Creating article metadata entries
+- Writing markdown content
+- Adding images and media
+- Updating the Service Worker cache
+- Testing articles locally
+- Publishing workflow
+
+### [Testing & Validation](./testing.md)
+
+Guide to running tests and ensuring code quality.
+
+**What you'll learn:**
+
+- Running Jest unit tests
+- Running Cypress E2E tests
+- Code linting with ESLint
+- Code formatting with Prettier
+- Markdown validation
+- Full validation pipeline
+- Debugging test failures
+- Continuous Integration (CI) process
+
+### [Deployment & Build](./deployment.md)
+
+Build process and deployment to GitHub Pages.
+
+**What you'll learn:**
+
+- Building production files (CSS, JS, Service Worker)
+- Understanding the deployment pipeline
+- GitHub Actions workflow
+- Pre-deployment checklist
+- Rollback procedures
+- Environment configuration
+- Performance optimization
+
+## Common Commands
+
+```bash
+# Local development
+npm run start              # Start dev server on port 3000
+
+# Testing
+npm run test               # Run Jest unit tests
+npm run cypress            # Open Cypress test runner
+npm run e2e:headless       # Run E2E tests in CI mode
+
+# Code Quality
+npm run eslint             # Fix ESLint errors
+npm run prettier           # Format all files
+npm run lint:markdown      # Validate markdown files
+
+# Build
+npm run build:css          # Compile CSS
+npm run build:js           # Minify JavaScript
+npm run workbox            # Regenerate Service Worker cache
+
+# Full Validation
+npm run validate           # Run all checks (required before merge)
+```
+
+## Related Documentation
+
+- [System Architecture](../architecture/system.md) — Understanding the codebase structure
+- [Data Flow](../architecture/data-flow.md) — How data moves through the application
+- [ArticleFiller API](../api/article-filler.md) — Core module documentation
diff --git a/docs/guide/testing.md b/docs/guide/testing.md
new file mode 100644
index 0000000..2a54082
--- /dev/null
+++ b/docs/guide/testing.md
@@ -0,0 +1,113 @@
+# Testing & Validation
+
+This guide covers running tests and validating code quality in Small Dev Talk.
+
+## Test Types
+
+Small Dev Talk uses three types of automated testing:
+
+1. **Unit Tests (Jest)** — Test individual functions and modules
+2. **E2E Tests (Cypress)** — Test complete user workflows
+3. **Linting** — Verify code quality and style
+4. **Markdown Validation** — Ensure documentation quality
+
+## Unit Testing with Jest
+
+Jest tests are in [src/scripts/index.test.js](../../src/scripts/index.test.js).
+
+**Run all tests:**
+
+```bash
+npm run test
+```
+
+**Run with verbose output:**
+
+```bash
+npm run test:verbose
+```
+
+**Run specific test file:**
+
+```bash
+npm run test -- src/scripts/index.test.js
+```
+
+## End-to-End Testing with Cypress
+
+Cypress tests are in [cypress/e2e/](../../cypress/e2e/).
+
+**Open Cypress Test Runner:**
+
+```bash
+npm run cypress
+```
+
+**Run E2E tests headless (CI mode):**
+
+```bash
+npm run e2e:headless
+```
+
+This starts the dev server, waits for it, then runs tests.
+
+## Code Quality
+
+### ESLint (JavaScript Linting)
+
+Check and auto-fix code quality issues:
+
+```bash
+npm run eslint              # Auto-fix
+npm run eslint:check        # Check only
+```
+
+**Configuration:** [eslint.config.js](../../eslint.config.js)
+
+### Prettier (Code Formatting)
+
+Format all code consistently:
+
+```bash
+npm run prettier            # Format all files
+npm run prettier:check      # Check only
+```
+
+**Configuration:** [.prettierrc](../../.prettierrc)
+
+### Markdownlint (Markdown Validation)
+
+Lint all markdown files:
+
+```bash
+npm run lint:markdown
+```
+
+**Configuration:** [.markdownlint.json](../../.markdownlint.json)
+
+## Full Validation Pipeline
+
+Run all quality checks together:
+
+```bash
+npm run validate
+```
+
+This runs:
+
+1. Prettier formatting
+2. ESLint code quality
+3. Jest unit tests
+4. Cypress E2E tests
+5. Markdownlint validation
+
+**Must pass before merging to master.**
+
+## Continuous Integration
+
+GitHub Actions automatically:
+
+- Runs all tests on pull requests
+- Reports status in PR
+- Blocks merging if tests fail
+- Deploys on merge to master
diff --git a/docs/index.md b/docs/index.md
new file mode 100644
index 0000000..6317d24
--- /dev/null
+++ b/docs/index.md
@@ -0,0 +1,72 @@
+# Small Dev Talk Documentation
+
+Welcome to the Small Dev Talk documentation. This directory contains comprehensive guides for understanding, maintaining, and extending the Small Dev Talk codebase.
+
+## Overview
+
+Small Dev Talk is a static web application that archives and displays interviews with indie developers, game developers, and creators across various entertainment industries. The site provides content from multiple authors spanning games, movies, technology, design, and more.
+
+The project is currently in **maintenance mode**, meaning focus is on bug fixes and security updates rather than new features.
+
+## Documentation Structure
+
+### [Architecture](./architecture/)
+
+Understand the system design, data flows, and core components that power Small Dev Talk.
+
+- [System Architecture](./architecture/system.md) — Overview of modules, components, and interactions
+- [Data Flow](./architecture/data-flow.md) — How articles flow through the application
+- [Dependencies & Integrations](./architecture/dependencies.md) — External services and libraries
+
+### [Guides](./guide/)
+
+Practical guides for developers working with the codebase.
+
+- [Developer Setup & Getting Started](./guide/getting-started.md) — Installation, configuration, and local development
+- [Adding & Publishing Articles](./guide/articles.md) — How to add new articles and manage article metadata
+- [Testing & Validation](./guide/testing.md) — Running tests, linting, and validation scripts
+- [Deployment & Build Process](./guide/deployment.md) — Building, testing, and deploying to production
+
+### [API Reference](./api/)
+
+Detailed documentation for key modules and functions.
+
+- [ArticleFiller Class](./api/article-filler.md) — Core class for article loading and page rendering
+- [Sentry Integration](./api/sentry.md) — Error tracking and monitoring configuration
+- [Service Worker](./api/service-worker.md) — Caching strategy and offline support
+- [Build Tools & Scripts](./api/build-tools.md) — Configuration for tooling and automation
+
+## Key Technologies
+
+| Technology                                                                   | Purpose                     | Version  |
+| ---------------------------------------------------------------------------- | --------------------------- | -------- |
+| [Bootstrap](https://getbootstrap.com/)                                       | UI framework                | Latest   |
+| [Showdown.js](http://showdownjs.com/)                                        | Markdown to HTML conversion | Latest   |
+| [Sentry](https://sentry.io/)                                                 | Error tracking              | v10.32.1 |
+| [Service Workers / Workbox](https://developers.google.com/web/tools/workbox) | Offline caching             | v7.4.0   |
+| [Jest](https://jestjs.io/)                                                   | Unit testing                | v30.2.0  |
+| [Cypress](https://cypress.io/)                                               | E2E testing                 | v15.8.1  |
+| [ESLint](https://eslint.org/)                                                | Code linting                | v9.39.2  |
+| [Prettier](https://prettier.io/)                                             | Code formatting             | v3.7.4   |
+
+## Quick Links
+
+- **Repository:** [AlexJSully/Small-Dev-Talk](https://github.com/AlexJSully/Small-Dev-Talk)
+- **Live Site:** [smalldevtalk.net](https://smalldevtalk.net/)
+- **Original Archive:** [Small Dev Talk on Tumblr](https://smalldevtalk.tumblr.com/)
+- **Issue Tracker:** [GitHub Issues](https://github.com/AlexJSully/Small-Dev-Talk/issues)
+
+## Current Status
+
+- **Project Status:** Maintenance Mode
+- **Latest Version:** 1.3.4
+- **License:** GPL-3.0
+- **Build Status:** Automated via GitHub Actions
+
+## Contributing
+
+To contribute, see [CONTRIBUTING.md](../CONTRIBUTING.md) at the repository root. Focus areas for contributions include:
+
+- Bug fixes (priority)
+- Security updates (priority)
+- Documentation improvements