From b9750b375944c3df8121d3e4c873def13fe92f16 Mon Sep 17 00:00:00 2001
From: Alex Gleason <alex@alexgleason.me>
Date: Sat, 21 Jun 2025 14:33:00 -0500
Subject: [PATCH 01/18] Update "Vibe with MKStack" link

---
 CONTEXT.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CONTEXT.md b/CONTEXT.md
index 06be660..a2f734e 100644
--- a/CONTEXT.md
+++ b/CONTEXT.md
@@ -102,7 +102,7 @@ The AI assistant's behavior and knowledge is defined by the CONTEXT.md file, whi
 
 ## "Vibed with MKStack"
 
-When building the site for the first time, include "Vibed with MKStack" somewhere in the UI, linked to this URL: https://soapbox.pub/tools/mkstack/
+When building the site for the first time, include "Vibed with MKStack" somewhere in the UI, linked to this URL: https://soapbox.pub/mkstack
 
 ## Nostr Protocol Integration
 

From b7ff219e6eca5f7f97dbd816639dbf5933e7ed2c Mon Sep 17 00:00:00 2001
From: Alex Gleason <alex@alexgleason.me>
Date: Mon, 23 Jun 2025 22:49:53 -0500
Subject: [PATCH 02/18] avatar: object-cover

---
 src/components/ui/avatar.tsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/components/ui/avatar.tsx b/src/components/ui/avatar.tsx
index 991f56e..2a948cb 100644
--- a/src/components/ui/avatar.tsx
+++ b/src/components/ui/avatar.tsx
@@ -24,7 +24,7 @@ const AvatarImage = React.forwardRef<
 >(({ className, ...props }, ref) => (
   <AvatarPrimitive.Image
     ref={ref}
-    className={cn("aspect-square h-full w-full", className)}
+    className={cn("aspect-square h-full w-full object-cover", className)}
     {...props}
   />
 ))

From 508fa84466016d06a90c3b9b8eb5255d0b5f79be Mon Sep 17 00:00:00 2001
From: Alex Gleason <alex@alexgleason.me>
Date: Tue, 24 Jun 2025 20:38:59 -0500
Subject: [PATCH 03/18] Default to Primal relay

---
 src/App.tsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/App.tsx b/src/App.tsx
index 2300f58..7cab833 100644
--- a/src/App.tsx
+++ b/src/App.tsx
@@ -32,7 +32,7 @@ const queryClient = new QueryClient({
 
 const defaultConfig: AppConfig = {
   theme: "light",
-  relayUrl: "wss://relay.nostr.band",
+  relayUrl: "wss://relay.primal.net",
 };
 
 const presetRelays = [

From 15dbc6df85431102c91d8660b3018efa3583478c Mon Sep 17 00:00:00 2001
From: Alex Gleason <alex@alexgleason.me>
Date: Thu, 26 Jun 2025 10:35:59 -0500
Subject: [PATCH 04/18] AccountSwitcher: modal={false}

---
 src/components/auth/AccountSwitcher.tsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/components/auth/AccountSwitcher.tsx b/src/components/auth/AccountSwitcher.tsx
index d3ebf5e..4f4518b 100644
--- a/src/components/auth/AccountSwitcher.tsx
+++ b/src/components/auth/AccountSwitcher.tsx
@@ -28,7 +28,7 @@ export function AccountSwitcher({ onAddAccountClick }: AccountSwitcherProps) {
   }
 
   return (
-    <DropdownMenu>
+    <DropdownMenu modal={false}>
       <DropdownMenuTrigger asChild>
         <button className='flex items-center gap-3 p-3 rounded-full hover:bg-accent transition-all w-full text-foreground'>
           <Avatar className='w-10 h-10'>

From fce2a3da2396ecbb00b33a405ffc3c7ba493fcfc Mon Sep 17 00:00:00 2001
From: Alex Gleason <alex@alexgleason.me>
Date: Thu, 26 Jun 2025 17:57:28 -0500
Subject: [PATCH 05/18] Give Dork 1 beer

---
 agent.json | 1 +
 1 file changed, 1 insertion(+)

diff --git a/agent.json b/agent.json
index 211f73f..de65194 100644
--- a/agent.json
+++ b/agent.json
@@ -1,5 +1,6 @@
 {
   "model": "claude-sonnet-4",
+  "temperature": 0.2,
   "mcpServers": {
     "js-dev": {
       "type": "stdio",

From 49952a10bfdafe3ce4403c373c0daa1d50988476 Mon Sep 17 00:00:00 2001
From: Alex Gleason <alex@alexgleason.me>
Date: Thu, 3 Jul 2025 19:04:40 -0500
Subject: [PATCH 06/18] Parse AppConfig with a zod schema

---
 package-lock.json              |  8 ++++----
 package.json                   |  2 +-
 src/components/AppProvider.tsx | 19 ++++++++++++++++++-
 3 files changed, 23 insertions(+), 6 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index dbfcfe7..fec8202 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -61,7 +61,7 @@
         "tailwind-merge": "^2.5.2",
         "tailwindcss-animate": "^1.0.7",
         "vaul": "^0.9.3",
-        "zod": "^3.23.8"
+        "zod": "^3.25.71"
       },
       "devDependencies": {
         "@eslint/js": "^9.9.0",
@@ -8244,9 +8244,9 @@
       }
     },
     "node_modules/zod": {
-      "version": "3.24.3",
-      "resolved": "https://registry.npmjs.org/zod/-/zod-3.24.3.tgz",
-      "integrity": "sha512-HhY1oqzWCQWuUqvBFnsyrtZRhyPeR7SUGv+C4+MsisMuVfSPx8HpwWqH8tRahSlt6M3PiFAcoeFhZAqIXTxoSg==",
+      "version": "3.25.71",
+      "resolved": "https://registry.npmjs.org/zod/-/zod-3.25.71.tgz",
+      "integrity": "sha512-BsBc/NPk7h8WsUWYWYL+BajcJPY8YhjelaWu2NMLuzgraKAz4Lb4/6K11g9jpuDetjMiqhZ6YaexFLOC0Ogi3Q==",
       "license": "MIT",
       "funding": {
         "url": "https://github.com/sponsors/colinhacks"
diff --git a/package.json b/package.json
index eefa69c..94d0460 100644
--- a/package.json
+++ b/package.json
@@ -63,7 +63,7 @@
     "tailwind-merge": "^2.5.2",
     "tailwindcss-animate": "^1.0.7",
     "vaul": "^0.9.3",
-    "zod": "^3.23.8"
+    "zod": "^3.25.71"
   },
   "devDependencies": {
     "@eslint/js": "^9.9.0",
diff --git a/src/components/AppProvider.tsx b/src/components/AppProvider.tsx
index d571e24..ebbbbe4 100644
--- a/src/components/AppProvider.tsx
+++ b/src/components/AppProvider.tsx
@@ -1,4 +1,5 @@
 import { ReactNode, useEffect } from 'react';
+import { z } from 'zod';
 import { useLocalStorage } from '@/hooks/useLocalStorage';
 import { AppContext, type AppConfig, type AppContextType, type Theme } from '@/contexts/AppContext';
 
@@ -12,6 +13,12 @@ interface AppProviderProps {
   presetRelays?: { name: string; url: string }[];
 }
 
+// Zod schema for AppConfig validation
+const AppConfigSchema: z.ZodType<AppConfig> = z.object({
+  theme: z.enum(['dark', 'light', 'system']),
+  relayUrl: z.string().url(),
+});
+
 export function AppProvider(props: AppProviderProps) {
   const {
     children,
@@ -21,7 +28,17 @@ export function AppProvider(props: AppProviderProps) {
   } = props;
 
   // App configuration state with localStorage persistence
-  const [config, setConfig] = useLocalStorage<AppConfig>(storageKey, defaultConfig);
+  const [config, setConfig] = useLocalStorage<AppConfig>(
+    storageKey,
+    defaultConfig,
+    {
+      serialize: JSON.stringify,
+      deserialize: (value: string) => {
+        const parsed = JSON.parse(value);
+        return AppConfigSchema.parse(parsed);
+      }
+    }
+  );
 
   // Generic config updater with callback pattern
   const updateConfig = (updater: (currentConfig: AppConfig) => AppConfig) => {

From 0cda9cb7fc33a0bfa2ac6dbab2090dda8c718ef6 Mon Sep 17 00:00:00 2001
From: Alex Gleason <alex@alexgleason.me>
Date: Thu, 3 Jul 2025 19:14:11 -0500
Subject: [PATCH 07/18] LoginDialog: use a password input Fixes
 https://gitlab.com/soapbox-pub/mkstack/-/issues/13

---
 src/components/auth/LoginDialog.tsx | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/components/auth/LoginDialog.tsx b/src/components/auth/LoginDialog.tsx
index 846f951..5e7e49c 100644
--- a/src/components/auth/LoginDialog.tsx
+++ b/src/components/auth/LoginDialog.tsx
@@ -135,6 +135,7 @@ const LoginDialog: React.FC<LoginDialogProps> = ({ isOpen, onClose, onLogin, onS
                     Enter your nsec
                   </label>
                   <Input
+                    type='password'
                     id='nsec'
                     value={nsec}
                     onChange={(e) => setNsec(e.target.value)}

From 37aaadbd7046cb2136d42343ac5a94a29dbde7c1 Mon Sep 17 00:00:00 2001
From: Alex Gleason <alex@alexgleason.me>
Date: Sat, 5 Jul 2025 12:33:22 -0500
Subject: [PATCH 08/18] gitignore .env files

---
 .gitignore | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/.gitignore b/.gitignore
index b485e7a..f74940e 100644
--- a/.gitignore
+++ b/.gitignore
@@ -23,3 +23,8 @@ dist-ssr
 
 # Vercel
 .vercel
+
+# Secrets
+.env
+.env.*
+!.env.example

From cadbc0294720023cb5c2f6e615ed4b66c803d901 Mon Sep 17 00:00:00 2001
From: Alex Gleason <alex@alexgleason.me>
Date: Sat, 5 Jul 2025 12:33:59 -0500
Subject: [PATCH 09/18] Remove unused goose recipe file

---
 recipe.yaml | 32 --------------------------------
 1 file changed, 32 deletions(-)
 delete mode 100644 recipe.yaml

diff --git a/recipe.yaml b/recipe.yaml
deleted file mode 100644
index 9529871..0000000
--- a/recipe.yaml
+++ /dev/null
@@ -1,32 +0,0 @@
-version: 1.0.0
-title: Nostr Client Development
-description: A recipe for building Nostr client applications
-instructions: Create a Nostr client application according to the user's request.
-extensions:
-  - type: builtin
-    name: developer
-    display_name: Developer Tools
-    timeout: 300
-    bundled: true
-  - type: stdio
-    name: nostr
-    cmd: npx
-    args:
-      - -y
-      - xjsr
-      - "@nostrbook/mcp"
-    envs: {}
-    timeout: 20
-    description: null
-    bundled: null
-  - type: stdio
-    name: fetch
-    cmd: uvx
-    args:
-      - mcp-server-fetch
-    envs: {}
-    timeout: 20
-    description: null
-    bundled: null
-author:
-  contact: Alex Gleason <alex@alexgleason.me>

From 65b974fb41aa1cdd656e9a982fe2c998e2566706 Mon Sep 17 00:00:00 2001
From: Alex Gleason <alex@alexgleason.me>
Date: Sat, 5 Jul 2025 12:45:16 -0500
Subject: [PATCH 10/18] vitest: suppress DOM output that exceeds AI context
 windows

---
 vite.config.ts | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/vite.config.ts b/vite.config.ts
index 58c54b2..650ac55 100644
--- a/vite.config.ts
+++ b/vite.config.ts
@@ -19,6 +19,9 @@ export default defineConfig(() => ({
     onConsoleLog(log) {
       return !log.includes("React Router Future Flag Warning");
     },
+    env: {
+      DEBUG_PRINT_LIMIT: '0', // Suppress DOM output that exceeds AI context windows
+    },
   },
   resolve: {
     alias: {

From a2eab78ae34535d606a8e389af1feac68d1d3d00 Mon Sep 17 00:00:00 2001
From: Alex Gleason <alex@alexgleason.me>
Date: Sat, 5 Jul 2025 17:50:21 -0500
Subject: [PATCH 11/18] Improve AppConfigSchema type

---
 src/components/AppProvider.tsx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/components/AppProvider.tsx b/src/components/AppProvider.tsx
index ebbbbe4..79c9e69 100644
--- a/src/components/AppProvider.tsx
+++ b/src/components/AppProvider.tsx
@@ -14,7 +14,7 @@ interface AppProviderProps {
 }
 
 // Zod schema for AppConfig validation
-const AppConfigSchema: z.ZodType<AppConfig> = z.object({
+const AppConfigSchema: z.ZodType<AppConfig, z.ZodTypeDef, unknown> = z.object({
   theme: z.enum(['dark', 'light', 'system']),
   relayUrl: z.string().url(),
 });

From 83db2fd53967064beba60b6d43cf2072bce58cb1 Mon Sep 17 00:00:00 2001
From: Alex Gleason <alex@alexgleason.me>
Date: Sat, 5 Jul 2025 19:14:30 -0500
Subject: [PATCH 12/18] CONTEXT.md: advise to add "alt" tags

---
 CONTEXT.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/CONTEXT.md b/CONTEXT.md
index a2f734e..577fcda 100644
--- a/CONTEXT.md
+++ b/CONTEXT.md
@@ -138,6 +138,8 @@ When implementing features that could use existing NIPs, follow this decision fr
    - The data structure is fundamentally different from existing patterns
    - The use case requires different storage characteristics (regular vs replaceable vs addressable)
 
+6. **Custom Kind Publishing**: When publishing events with custom kinds generated by `nostr__generate_kind`, always include a NIP-31 "alt" tag with a human-readable description of the event's purpose.
+
 **Example Decision Process**:
 ```
 Need: Equipment marketplace for farmers

From 39afb03570056702d991824c71a358dec8f482ef Mon Sep 17 00:00:00 2001
From: Alex Gleason <alex@alexgleason.me>
Date: Sun, 6 Jul 2025 18:44:42 -0500
Subject: [PATCH 13/18] Stronger language against writing unnecessary tests

---
 CONTEXT.md | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/CONTEXT.md b/CONTEXT.md
index 577fcda..61f8a2c 100644
--- a/CONTEXT.md
+++ b/CONTEXT.md
@@ -813,7 +813,13 @@ When users specify color schemes:
 
 ## Writing Tests
 
-**Important for AI Assistants**: Only create tests when the user is experiencing a specific problem or explicitly requests tests. Do not proactively write tests for new features or components unless the user is having issues that require testing to diagnose or resolve.
+**⚠️ CRITICAL FOR AI ASSISTANTS**: **DO NOT WRITE TESTS** unless the user is experiencing a specific problem or explicitly requests tests. Writing unnecessary tests wastes significant time and money. Only create tests when:
+
+1. **The user is experiencing a bug** that requires testing to diagnose
+2. **The user explicitly asks for tests** to be written
+3. **Existing functionality is broken** and tests are needed to verify fixes
+
+**Never proactively write tests** for new features or components. Focus on building functionality that works, not on testing it unless specifically requested.
 
 ### Test Setup
 

From 414e0bf02904f24592d6b9b29482ba87867d7030 Mon Sep 17 00:00:00 2001
From: Derek Ross <derekross@gmail.com>
Date: Tue, 8 Jul 2025 23:04:45 -0400
Subject: [PATCH 14/18] feat: add gemini-cli support

---
 .gemini/settings.json | 1 +
 GEMINI.md             | 1 +
 2 files changed, 2 insertions(+)
 create mode 120000 .gemini/settings.json
 create mode 120000 GEMINI.md

diff --git a/.gemini/settings.json b/.gemini/settings.json
new file mode 120000
index 0000000..c67157d
--- /dev/null
+++ b/.gemini/settings.json
@@ -0,0 +1 @@
+../.mcp.json
\ No newline at end of file
diff --git a/GEMINI.md b/GEMINI.md
new file mode 120000
index 0000000..fa62d27
--- /dev/null
+++ b/GEMINI.md
@@ -0,0 +1 @@
+CONTEXT.md
\ No newline at end of file

From f7736ddfb134dc6b03849e23c318d334aee50f96 Mon Sep 17 00:00:00 2001
From: Alex Gleason <alex@alexgleason.me>
Date: Sat, 12 Jul 2025 18:56:22 -0500
Subject: [PATCH 15/18] Upgrade Nostrify

---
 package-lock.json | 30 +++++++++++++++---------------
 package.json      |  4 ++--
 2 files changed, 17 insertions(+), 17 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index fec8202..b00e92a 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -9,8 +9,8 @@
       "version": "0.0.0",
       "dependencies": {
         "@hookform/resolvers": "^3.9.0",
-        "@nostrify/nostrify": "npm:@jsr/nostrify__nostrify@^0.46.1",
-        "@nostrify/react": "npm:@jsr/nostrify__react@^0.2.5",
+        "@nostrify/nostrify": "npm:@jsr/nostrify__nostrify@^0.46.3",
+        "@nostrify/react": "npm:@jsr/nostrify__react@^0.2.7",
         "@radix-ui/react-accordion": "^1.2.0",
         "@radix-ui/react-alert-dialog": "^1.1.1",
         "@radix-ui/react-aspect-ratio": "^1.1.0",
@@ -1205,15 +1205,15 @@
       }
     },
     "node_modules/@jsr/nostrify__nostrify": {
-      "version": "0.46.1",
-      "resolved": "https://npm.jsr.io/~/11/@jsr/nostrify__nostrify/0.46.1.tgz",
-      "integrity": "sha512-7XSP4+kjcPgw937jQPUxf+qo1mWx7rbKUuA5ma0CofRQZa2v01IA4f+OfVGJbABxbJ8SC+8VdPkLqqUOJxeVPg==",
+      "version": "0.46.3",
+      "resolved": "https://npm.jsr.io/~/11/@jsr/nostrify__nostrify/0.46.3.tgz",
+      "integrity": "sha512-zJpOrD8bbrJroLRJjESAJZX/ZKFCaGfoz5fSfLP+gIcTiPo8JpzlrFBF6mvaDI/Mdd+1WTBwlCcW9On8rUVH7w==",
       "dependencies": {
         "@jsr/nostrify__types": "^0.36.0",
         "@jsr/scure__base": "^1.2.4",
         "@jsr/std__encoding": "^0.224.1",
         "lru-cache": "^10.2.0",
-        "nostr-tools": "^2.10.4",
+        "nostr-tools": "^2.13.0",
         "websocket-ts": "^2.2.1",
         "zod": "^3.23.8"
       }
@@ -1315,27 +1315,27 @@
     },
     "node_modules/@nostrify/nostrify": {
       "name": "@jsr/nostrify__nostrify",
-      "version": "0.46.1",
-      "resolved": "https://npm.jsr.io/~/11/@jsr/nostrify__nostrify/0.46.1.tgz",
-      "integrity": "sha512-7XSP4+kjcPgw937jQPUxf+qo1mWx7rbKUuA5ma0CofRQZa2v01IA4f+OfVGJbABxbJ8SC+8VdPkLqqUOJxeVPg==",
+      "version": "0.46.3",
+      "resolved": "https://npm.jsr.io/~/11/@jsr/nostrify__nostrify/0.46.3.tgz",
+      "integrity": "sha512-zJpOrD8bbrJroLRJjESAJZX/ZKFCaGfoz5fSfLP+gIcTiPo8JpzlrFBF6mvaDI/Mdd+1WTBwlCcW9On8rUVH7w==",
       "dependencies": {
         "@jsr/nostrify__types": "^0.36.0",
         "@jsr/scure__base": "^1.2.4",
         "@jsr/std__encoding": "^0.224.1",
         "lru-cache": "^10.2.0",
-        "nostr-tools": "^2.10.4",
+        "nostr-tools": "^2.13.0",
         "websocket-ts": "^2.2.1",
         "zod": "^3.23.8"
       }
     },
     "node_modules/@nostrify/react": {
       "name": "@jsr/nostrify__react",
-      "version": "0.2.5",
-      "resolved": "https://npm.jsr.io/~/11/@jsr/nostrify__react/0.2.5.tgz",
-      "integrity": "sha512-Hyi1N4hXa89gYsuk7fqGrWEzIzTp7md8hKog+D2DgpSqVwFQM1vw267Uv3rOieE/hPereD3gen9X88XkeAXP+Q==",
+      "version": "0.2.7",
+      "resolved": "https://npm.jsr.io/~/11/@jsr/nostrify__react/0.2.7.tgz",
+      "integrity": "sha512-36fAOOymf34KR2OfE4jXBojbZnPsrIzQDAXzE7dko8/Qj+0s8iKnZoZKg9DVIT2F6Lxhr6SUiTze8xBxuJbf1A==",
       "dependencies": {
-        "@jsr/nostrify__nostrify": "^0.46.1",
-        "nostr-tools": "^2.10.4",
+        "@jsr/nostrify__nostrify": "^0.46.3",
+        "nostr-tools": "^2.13.0",
         "react": "^18.0.0"
       }
     },
diff --git a/package.json b/package.json
index 94d0460..f5170fe 100644
--- a/package.json
+++ b/package.json
@@ -11,8 +11,8 @@
   },
   "dependencies": {
     "@hookform/resolvers": "^3.9.0",
-    "@nostrify/nostrify": "npm:@jsr/nostrify__nostrify@^0.46.1",
-    "@nostrify/react": "npm:@jsr/nostrify__react@^0.2.5",
+    "@nostrify/nostrify": "npm:@jsr/nostrify__nostrify@^0.46.3",
+    "@nostrify/react": "npm:@jsr/nostrify__react@^0.2.7",
     "@radix-ui/react-accordion": "^1.2.0",
     "@radix-ui/react-alert-dialog": "^1.1.1",
     "@radix-ui/react-aspect-ratio": "^1.1.0",

From 3b48df1093ef070d55aeb8cfb2e3d5e19711d830 Mon Sep 17 00:00:00 2001
From: Alex Gleason <alex@alexgleason.me>
Date: Sun, 13 Jul 2025 17:33:00 -0500
Subject: [PATCH 16/18] gitlab-ci: run tests in CI, not build (always before
 deploy)

---
 .gitlab-ci.yml | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index 6afba16..14b7efa 100644
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -5,16 +5,13 @@ default:
   timeout: 1 minute
 
 stages:
-  - build
+  - test
   - deploy
 
-build:
-  stage: build
+test:
+  stage: test
   script:
-    - npm run build
-  only:
-    variables:
-      - $CI_DEFAULT_BRANCH != $CI_COMMIT_REF_NAME
+    - npm run test
 
 pages:
   stage: deploy

From f75ddb66548679ddecaf562d94e75ffdbfdb547e Mon Sep 17 00:00:00 2001
From: Alex Gleason <alex@alexgleason.me>
Date: Sun, 13 Jul 2025 18:38:48 -0500
Subject: [PATCH 17/18] Add CommentsSection for NIP-22 (kind 1111) comments

---
 CONTEXT.md                                  |  55 +++++++
 src/components/comments/Comment.tsx         | 153 ++++++++++++++++++++
 src/components/comments/CommentForm.tsx     |  90 ++++++++++++
 src/components/comments/CommentsSection.tsx | 100 +++++++++++++
 src/hooks/useComments.ts                    |  98 +++++++++++++
 src/hooks/usePostComment.ts                 |  92 ++++++++++++
 6 files changed, 588 insertions(+)
 create mode 100644 src/components/comments/Comment.tsx
 create mode 100644 src/components/comments/CommentForm.tsx
 create mode 100644 src/components/comments/CommentsSection.tsx
 create mode 100644 src/hooks/useComments.ts
 create mode 100644 src/hooks/usePostComment.ts

diff --git a/CONTEXT.md b/CONTEXT.md
index 61f8a2c..d586bb0 100644
--- a/CONTEXT.md
+++ b/CONTEXT.md
@@ -651,6 +651,61 @@ export function Post(/* ...props */) {
 }
 ```
 
+### Adding Comments Sections
+
+The project includes a complete commenting system using NIP-22 (kind 1111) comments that can be added to any Nostr event or URL. The `CommentsSection` component provides a full-featured commenting interface with threaded replies, user authentication, and real-time updates.
+
+#### Basic Usage
+
+```tsx
+import { CommentsSection } from "@/components/comments/CommentsSection";
+
+function ArticlePage({ article }: { article: NostrEvent }) {
+  return (
+    <div className="space-y-6">
+      {/* Your article content */}
+      <div>{/* article content */}</div>
+
+      {/* Comments section */}
+      <CommentsSection root={article} />
+    </div>
+  );
+}
+```
+
+#### Props and Customization
+
+The `CommentsSection` component accepts the following props:
+
+- **`root`** (required): The root event or URL to comment on. Can be a `NostrEvent` or `URL` object.
+- **`title`**: Custom title for the comments section (default: "Comments")
+- **`emptyStateMessage`**: Message shown when no comments exist (default: "No comments yet")
+- **`emptyStateSubtitle`**: Subtitle for empty state (default: "Be the first to share your thoughts!")
+- **`className`**: Additional CSS classes for styling
+- **`limit`**: Maximum number of comments to load (default: 500)
+
+```tsx
+<CommentsSection
+  root={event}
+  title="Discussion"
+  emptyStateMessage="Start the conversation"
+  emptyStateSubtitle="Share your thoughts about this post"
+  className="mt-8"
+  limit={100}
+/>
+```
+
+#### Commenting on URLs
+
+The comments system also supports commenting on external URLs, making it useful for web pages, articles, or any online content:
+
+```tsx
+<CommentsSection
+  root={new URL("https://example.com/article")}
+  title="Comments on this article"
+/>
+```
+
 ## App Configuration
 
 The project includes an `AppProvider` that manages global application state including theme and relay configuration. The default configuration includes:
diff --git a/src/components/comments/Comment.tsx b/src/components/comments/Comment.tsx
new file mode 100644
index 0000000..54658ae
--- /dev/null
+++ b/src/components/comments/Comment.tsx
@@ -0,0 +1,153 @@
+import { useState } from 'react';
+import { Link } from 'react-router-dom';
+import { NostrEvent } from '@nostrify/nostrify';
+import { nip19 } from 'nostr-tools';
+import { useAuthor } from '@/hooks/useAuthor';
+import { useComments } from '@/hooks/useComments';
+import { CommentForm } from './CommentForm';
+import { NoteContent } from '@/components/NoteContent';
+import { Avatar, AvatarFallback, AvatarImage } from '@/components/ui/avatar';
+import { Button } from '@/components/ui/button';
+import { Card, CardContent } from '@/components/ui/card';
+import { Collapsible, CollapsibleContent, CollapsibleTrigger } from '@/components/ui/collapsible';
+import { DropdownMenu, DropdownMenuTrigger } from '@/components/ui/dropdown-menu';
+import { MessageSquare, ChevronDown, ChevronRight, MoreHorizontal } from 'lucide-react';
+import { formatDistanceToNow } from 'date-fns';
+import { genUserName } from '@/lib/genUserName';
+
+interface CommentProps {
+  root: NostrEvent | URL;
+  comment: NostrEvent;
+  depth?: number;
+  maxDepth?: number;
+  limit?: number;
+}
+
+export function Comment({ root, comment, depth = 0, maxDepth = 3, limit }: CommentProps) {
+  const [showReplyForm, setShowReplyForm] = useState(false);
+  const [showReplies, setShowReplies] = useState(depth < 2); // Auto-expand first 2 levels
+  
+  const author = useAuthor(comment.pubkey);
+  const { data: commentsData } = useComments(root, limit);
+  
+  const metadata = author.data?.metadata;
+  const displayName = metadata?.name ?? genUserName(comment.pubkey)
+  const timeAgo = formatDistanceToNow(new Date(comment.created_at * 1000), { addSuffix: true });
+
+  // Get direct replies to this comment
+  const replies = commentsData?.getDirectReplies(comment.id) || [];
+  const hasReplies = replies.length > 0;
+
+  return (
+    <div className={`space-y-3 ${depth > 0 ? 'ml-6 border-l-2 border-muted pl-4' : ''}`}>
+      <Card className="bg-card/50">
+        <CardContent className="p-4">
+          <div className="space-y-3">
+            {/* Comment Header */}
+            <div className="flex items-start justify-between">
+              <div className="flex items-center space-x-3">
+                <Link to={`/${nip19.npubEncode(comment.pubkey)}`}>
+                  <Avatar className="h-8 w-8 hover:ring-2 hover:ring-primary/30 transition-all cursor-pointer">
+                    <AvatarImage src={metadata?.picture} />
+                    <AvatarFallback className="text-xs">
+                      {displayName.charAt(0)}
+                    </AvatarFallback>
+                  </Avatar>
+                </Link>
+                <div>
+                  <Link 
+                    to={`/${nip19.npubEncode(comment.pubkey)}`}
+                    className="font-medium text-sm hover:text-primary transition-colors"
+                  >
+                    {displayName}
+                  </Link>
+                  <p className="text-xs text-muted-foreground">{timeAgo}</p>
+                </div>
+              </div>
+            </div>
+
+            {/* Comment Content */}
+            <div className="text-sm">
+              <NoteContent event={comment} className="text-sm" />
+            </div>
+
+            {/* Comment Actions */}
+            <div className="flex items-center justify-between pt-2">
+              <div className="flex items-center space-x-2">
+                <Button
+                  variant="ghost"
+                  size="sm"
+                  onClick={() => setShowReplyForm(!showReplyForm)}
+                  className="h-8 px-2 text-xs"
+                >
+                  <MessageSquare className="h-3 w-3 mr-1" />
+                  Reply
+                </Button>
+                
+                {hasReplies && (
+                  <Collapsible open={showReplies} onOpenChange={setShowReplies}>
+                    <CollapsibleTrigger asChild>
+                      <Button variant="ghost" size="sm" className="h-8 px-2 text-xs">
+                        {showReplies ? (
+                          <ChevronDown className="h-3 w-3 mr-1" />
+                        ) : (
+                          <ChevronRight className="h-3 w-3 mr-1" />
+                        )}
+                        {replies.length} {replies.length === 1 ? 'reply' : 'replies'}
+                      </Button>
+                    </CollapsibleTrigger>
+                  </Collapsible>
+                )}
+              </div>
+
+              {/* Comment menu */}
+              <DropdownMenu>
+                <DropdownMenuTrigger asChild>
+                  <Button
+                    variant="ghost"
+                    size="sm"
+                    className="h-8 px-2 text-xs"
+                    aria-label="Comment options"
+                  >
+                    <MoreHorizontal className="h-3 w-3" />
+                  </Button>
+                </DropdownMenuTrigger>
+              </DropdownMenu>
+            </div>
+          </div>
+        </CardContent>
+      </Card>
+
+      {/* Reply Form */}
+      {showReplyForm && (
+        <div className="ml-6">
+          <CommentForm
+            root={root}
+            reply={comment}
+            onSuccess={() => setShowReplyForm(false)}
+            placeholder="Write a reply..."
+            compact
+          />
+        </div>
+      )}
+
+      {/* Replies */}
+      {hasReplies && (
+        <Collapsible open={showReplies} onOpenChange={setShowReplies}>
+          <CollapsibleContent className="space-y-3">
+            {replies.map((reply) => (
+              <Comment
+                key={reply.id}
+                root={root}
+                comment={reply}
+                depth={depth + 1}
+                maxDepth={maxDepth}
+                limit={limit}
+              />
+            ))}
+          </CollapsibleContent>
+        </Collapsible>
+      )}
+    </div>
+  );
+}
\ No newline at end of file
diff --git a/src/components/comments/CommentForm.tsx b/src/components/comments/CommentForm.tsx
new file mode 100644
index 0000000..7c973f2
--- /dev/null
+++ b/src/components/comments/CommentForm.tsx
@@ -0,0 +1,90 @@
+import { useState } from 'react';
+import { Button } from '@/components/ui/button';
+import { Textarea } from '@/components/ui/textarea';
+import { Card, CardContent } from '@/components/ui/card';
+import { useCurrentUser } from '@/hooks/useCurrentUser';
+import { usePostComment } from '@/hooks/usePostComment';
+import { LoginArea } from '@/components/auth/LoginArea';
+import { NostrEvent } from '@nostrify/nostrify';
+import { MessageSquare, Send } from 'lucide-react';
+
+interface CommentFormProps {
+  root: NostrEvent | URL;
+  reply?: NostrEvent | URL;
+  onSuccess?: () => void;
+  placeholder?: string;
+  compact?: boolean;
+}
+
+export function CommentForm({
+  root,
+  reply,
+  onSuccess, 
+  placeholder = "Write a comment...",
+  compact = false 
+}: CommentFormProps) {
+  const [content, setContent] = useState('');
+  const { user } = useCurrentUser();
+  const { mutate: postComment, isPending } = usePostComment();
+
+  const handleSubmit = (e: React.FormEvent) => {
+    e.preventDefault();
+    
+    if (!content.trim() || !user) return;
+
+    postComment(
+      { content: content.trim(), root, reply },
+      {
+        onSuccess: () => {
+          setContent('');
+          onSuccess?.();
+        },
+      }
+    );
+  };
+
+  if (!user) {
+    return (
+      <Card className={compact ? "border-dashed" : ""}>
+        <CardContent className={compact ? "p-4" : "p-6"}>
+          <div className="text-center space-y-4">
+            <div className="flex items-center justify-center space-x-2 text-muted-foreground">
+              <MessageSquare className="h-5 w-5" />
+              <span>Sign in to {reply ? 'reply' : 'comment'}</span>
+            </div>
+            <LoginArea />
+          </div>
+        </CardContent>
+      </Card>
+    );
+  }
+
+  return (
+    <Card className={compact ? "border-dashed" : ""}>
+      <CardContent className={compact ? "p-4" : "p-6"}>
+        <form onSubmit={handleSubmit} className="space-y-4">
+          <Textarea
+            value={content}
+            onChange={(e) => setContent(e.target.value)}
+            placeholder={placeholder}
+            className={compact ? "min-h-[80px]" : "min-h-[100px]"}
+            disabled={isPending}
+          />
+          <div className="flex justify-between items-center">
+            <span className="text-sm text-muted-foreground">
+              {reply ? 'Replying to comment' : 'Adding to the discussion'}
+            </span>
+            <Button 
+              type="submit" 
+              disabled={!content.trim() || isPending}
+              size={compact ? "sm" : "default"}
+            >
+              <Send className="h-4 w-4 mr-2" />
+              {isPending ? 'Posting...' : (reply ? 'Reply' : 'Comment')}
+            </Button>
+          </div>
+        </form>
+      </CardContent>
+    </Card>
+  );
+}
\ No newline at end of file
diff --git a/src/components/comments/CommentsSection.tsx b/src/components/comments/CommentsSection.tsx
new file mode 100644
index 0000000..a269934
--- /dev/null
+++ b/src/components/comments/CommentsSection.tsx
@@ -0,0 +1,100 @@
+import { useComments } from '@/hooks/useComments';
+import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card';
+import { Skeleton } from '@/components/ui/skeleton';
+import { MessageSquare } from 'lucide-react';
+import { cn } from '@/lib/utils';
+import type { NostrEvent } from '@nostrify/nostrify';
+import { CommentForm } from './CommentForm';
+import { Comment } from './Comment';
+
+interface CommentsSectionProps {
+  root: NostrEvent | URL;
+  title?: string;
+  emptyStateMessage?: string;
+  emptyStateSubtitle?: string;
+  className?: string;
+  limit?: number;
+}
+
+export function CommentsSection({ 
+  root,
+  title = "Comments",
+  emptyStateMessage = "No comments yet",
+  emptyStateSubtitle = "Be the first to share your thoughts!",
+  className,
+  limit = 500,
+}: CommentsSectionProps) {
+  const { data: commentsData, isLoading, error } = useComments(root, limit);
+  const comments = commentsData?.topLevelComments || [];
+
+  if (error) {
+    return (
+      <Card className="rounded-none sm:rounded-lg mx-0 sm:mx-0">
+        <CardContent className="px-2 py-6 sm:p-6">
+          <div className="text-center text-muted-foreground">
+            <MessageSquare className="h-8 w-8 mx-auto mb-2 opacity-50" />
+            <p>Failed to load comments</p>
+          </div>
+        </CardContent>
+      </Card>
+    );
+  }
+
+  return (
+    <Card className={cn("rounded-none sm:rounded-lg mx-0 sm:mx-0", className)}>
+      <CardHeader className="px-2 pt-6 pb-4 sm:p-6">
+        <CardTitle className="flex items-center space-x-2">
+          <MessageSquare className="h-5 w-5" />
+          <span>{title}</span>
+          {!isLoading && (
+            <span className="text-sm font-normal text-muted-foreground">
+              ({comments.length})
+            </span>
+          )}
+        </CardTitle>
+      </CardHeader>
+      <CardContent className="px-2 pb-6 pt-4 sm:p-6 sm:pt-0 space-y-6">
+        {/* Comment Form */}
+        <CommentForm root={root} />
+
+        {/* Comments List */}
+        {isLoading ? (
+          <div className="space-y-4">
+            {[...Array(3)].map((_, i) => (
+              <Card key={i} className="bg-card/50">
+                <CardContent className="p-4">
+                  <div className="space-y-3">
+                    <div className="flex items-center space-x-3">
+                      <Skeleton className="h-8 w-8 rounded-full" />
+                      <div className="space-y-1">
+                        <Skeleton className="h-4 w-24" />
+                        <Skeleton className="h-3 w-16" />
+                      </div>
+                    </div>
+                    <Skeleton className="h-16 w-full" />
+                  </div>
+                </CardContent>
+              </Card>
+            ))}
+          </div>
+        ) : comments.length === 0 ? (
+          <div className="text-center py-8 text-muted-foreground">
+            <MessageSquare className="h-12 w-12 mx-auto mb-4 opacity-30" />
+            <p className="text-lg font-medium mb-2">{emptyStateMessage}</p>
+            <p className="text-sm">{emptyStateSubtitle}</p>
+          </div>
+        ) : (
+          <div className="space-y-4">
+            {comments.map((comment) => (
+              <Comment
+                key={comment.id}
+                root={root}
+                comment={comment}
+              />
+            ))}
+          </div>
+        )}
+      </CardContent>
+    </Card>
+  );
+}
\ No newline at end of file
diff --git a/src/hooks/useComments.ts b/src/hooks/useComments.ts
new file mode 100644
index 0000000..49922c5
--- /dev/null
+++ b/src/hooks/useComments.ts
@@ -0,0 +1,98 @@
+import { NKinds, NostrEvent, NostrFilter } from '@nostrify/nostrify';
+import { useNostr } from '@nostrify/react';
+import { useQuery } from '@tanstack/react-query';
+
+export function useComments(root: NostrEvent | URL, limit?: number) {
+  const { nostr } = useNostr();
+
+  return useQuery({
+    queryKey: ['comments', root instanceof URL ? root.toString() : root.id, limit],
+    queryFn: async (c) => {
+      const filter: NostrFilter = { kinds: [1111] };
+
+      if (root instanceof URL) {
+        filter['#I'] = [root.toString()];
+      } else if (NKinds.addressable(root.kind)) {
+        const d = root.tags.find(([name]) => name === 'd')?.[1] ?? '';
+        filter['#A'] = [`${root.kind}:${root.pubkey}:${d}`];
+      } else if (NKinds.replaceable(root.kind)) {
+        filter['#A'] = [`${root.kind}:${root.pubkey}:`];
+      } else {
+        filter['#E'] = [root.id];
+      }
+
+      if (typeof limit === 'number') {
+        filter.limit = limit;
+      }
+
+      // Query for all kind 1111 comments that reference this addressable event regardless of depth
+      const signal = AbortSignal.any([c.signal, AbortSignal.timeout(5000)]);
+      const events = await nostr.query([filter], { signal });
+
+      // Helper function to get tag value
+      const getTagValue = (event: NostrEvent, tagName: string): string | undefined => {
+        const tag = event.tags.find(([name]) => name === tagName);
+        return tag?.[1];
+      };
+
+      // Filter top-level comments (those with lowercase tag matching the root)
+      const topLevelComments = events.filter(comment => {
+        if (root instanceof URL) {
+          return getTagValue(comment, 'i') === root.toString();
+        } else if (NKinds.addressable(root.kind)) {
+          const d = getTagValue(root, 'd') ?? '';
+          return getTagValue(comment, 'a') === `${root.kind}:${root.pubkey}:${d}`;
+        } else if (NKinds.replaceable(root.kind)) {
+          return getTagValue(comment, 'a') === `${root.kind}:${root.pubkey}:`;
+        } else {
+          return getTagValue(comment, 'e') === root.id;
+        }
+      });
+
+      // Helper function to get all descendants of a comment
+      const getDescendants = (parentId: string): NostrEvent[] => {
+        const directReplies = events.filter(comment => {
+          const eTag = getTagValue(comment, 'e');
+          return eTag === parentId;
+        });
+
+        const allDescendants = [...directReplies];
+        
+        // Recursively get descendants of each direct reply
+        for (const reply of directReplies) {
+          allDescendants.push(...getDescendants(reply.id));
+        }
+
+        return allDescendants;
+      };
+
+      // Create a map of comment ID to its descendants
+      const commentDescendants = new Map<string, NostrEvent[]>();
+      for (const comment of events) {
+        commentDescendants.set(comment.id, getDescendants(comment.id));
+      }
+
+      // Sort top-level comments by creation time (newest first)
+      const sortedTopLevel = topLevelComments.sort((a, b) => b.created_at - a.created_at);
+
+      return {
+        allComments: events,
+        topLevelComments: sortedTopLevel,
+        getDescendants: (commentId: string) => {
+          const descendants = commentDescendants.get(commentId) || [];
+          // Sort descendants by creation time (oldest first for threaded display)
+          return descendants.sort((a, b) => a.created_at - b.created_at);
+        },
+        getDirectReplies: (commentId: string) => {
+          const directReplies = events.filter(comment => {
+            const eTag = getTagValue(comment, 'e');
+            return eTag === commentId;
+          });
+          // Sort direct replies by creation time (oldest first for threaded display)
+          return directReplies.sort((a, b) => a.created_at - b.created_at);
+        }
+      };
+    },
+    enabled: !!root,
+  });
+}
\ No newline at end of file
diff --git a/src/hooks/usePostComment.ts b/src/hooks/usePostComment.ts
new file mode 100644
index 0000000..30fe3eb
--- /dev/null
+++ b/src/hooks/usePostComment.ts
@@ -0,0 +1,92 @@
+import { useMutation, useQueryClient } from '@tanstack/react-query';
+import { useNostrPublish } from '@/hooks/useNostrPublish';
+import { NKinds, type NostrEvent } from '@nostrify/nostrify';
+
+interface PostCommentParams {
+  root: NostrEvent | URL; // The root event to comment on
+  reply?: NostrEvent | URL; // Optional reply to another comment
+  content: string;
+}
+
+/** Post a NIP-22 (kind 1111) comment on an event. */
+export function usePostComment() {
+  const { mutateAsync: publishEvent } = useNostrPublish();
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({ root, reply, content }: PostCommentParams) => {
+      const tags: string[][] = [];
+
+      // d-tag identifiers
+      const dRoot = root instanceof URL ? '' : root.tags.find(([name]) => name === 'd')?.[1] ?? '';
+      const dReply = reply instanceof URL ? '' : reply?.tags.find(([name]) => name === 'd')?.[1] ?? '';
+
+      // Root event tags
+      if (root instanceof URL) {
+        tags.push(['I', root.toString()]);
+      } else if (NKinds.addressable(root.kind)) {
+        tags.push(['A', `${root.kind}:${root.pubkey}:${dRoot}`]);
+      } else if (NKinds.replaceable(root.kind)) {
+        tags.push(['A', `${root.kind}:${root.pubkey}:`]);
+      } else {
+        tags.push(['E', root.id]);
+      }
+      if (root instanceof URL) {
+        tags.push(['K', root.hostname]);
+      } else {
+        tags.push(['K', root.kind.toString()]);
+        tags.push(['P', root.pubkey]);
+      }
+
+      // Reply event tags
+      if (reply) {
+        if (reply instanceof URL) {
+          tags.push(['i', reply.toString()]);
+        } else if (NKinds.addressable(reply.kind)) {
+          tags.push(['a', `${reply.kind}:${reply.pubkey}:${dReply}`]);
+        } else if (NKinds.replaceable(reply.kind)) {
+          tags.push(['a', `${reply.kind}:${reply.pubkey}:`]);
+        } else {
+          tags.push(['e', reply.id]);
+        }
+        if (reply instanceof URL) {
+          tags.push(['k', reply.hostname]);
+        } else {
+          tags.push(['k', reply.kind.toString()]);
+          tags.push(['p', reply.pubkey]);
+        }
+      } else {
+        // If this is a top-level comment, use the root event's tags
+        if (root instanceof URL) {
+          tags.push(['i', root.toString()]);
+        } else if (NKinds.addressable(root.kind)) {
+          tags.push(['a', `${root.kind}:${root.pubkey}:${dRoot}`]);
+        } else if (NKinds.replaceable(root.kind)) {
+          tags.push(['a', `${root.kind}:${root.pubkey}:`]);
+        } else {
+          tags.push(['e', root.id]);
+        }
+        if (root instanceof URL) {
+          tags.push(['k', root.hostname]);
+        } else {
+          tags.push(['k', root.kind.toString()]);
+          tags.push(['p', root.pubkey]);
+        }
+      }
+
+      const event = await publishEvent({
+        kind: 1111,
+        content,
+        tags,
+      });
+
+      return event;
+    },
+    onSuccess: (_, { root }) => {
+      // Invalidate and refetch comments
+      queryClient.invalidateQueries({
+        queryKey: ['comments', root instanceof URL ? root.toString() : root.id]
+      });
+    },
+  });
+}
\ No newline at end of file

From a76c292fec69b5fcb2df991193539985f8c32349 Mon Sep 17 00:00:00 2001
From: Alex Gleason <alex@alexgleason.me>
Date: Mon, 14 Jul 2025 02:53:25 -0500
Subject: [PATCH 18/18] "Writing Tests" clarifications

---
 CONTEXT.md | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/CONTEXT.md b/CONTEXT.md
index d586bb0..413d7fb 100644
--- a/CONTEXT.md
+++ b/CONTEXT.md
@@ -868,13 +868,17 @@ When users specify color schemes:
 
 ## Writing Tests
 
-**⚠️ CRITICAL FOR AI ASSISTANTS**: **DO NOT WRITE TESTS** unless the user is experiencing a specific problem or explicitly requests tests. Writing unnecessary tests wastes significant time and money. Only create tests when:
+**Do not write tests** unless the user explicitly requests them in plain language. Writing unnecessary tests wastes significant time and money. Only create tests when:
 
-1. **The user is experiencing a bug** that requires testing to diagnose
-2. **The user explicitly asks for tests** to be written
-3. **Existing functionality is broken** and tests are needed to verify fixes
+1. **The user explicitly asks for tests** to be written in their message
+2. **The user describes a specific bug in plain language** and requests tests to help diagnose it
+3. **The user says they are still experiencing a problem** that you have already attempted to solve (tests can help verify the fix)
 
-**Never proactively write tests** for new features or components. Focus on building functionality that works, not on testing it unless specifically requested.
+**Never write tests because:**
+- Tool results show test failures (these are not user requests)
+- You think tests would be helpful
+- New features or components are created
+- Existing functionality needs verification
 
 ### Test Setup