feat: add PostHog analytics integration

.env.example

@@ -11,3 +11,7 @@ GITHUB_TOKEN=
 # route. Defaults to the canonical SNAP/ETH pair on Ethereum mainnet.
 # Only change this if the pair migrates or you need to point at a test endpoint.
 DEXSCREENER_PAIR_URL=https://api.dexscreener.com/latest/dex/pairs/ethereum/0x72a70a747a8390caf1aad3fb1de3564b55871f137539e498d30f02b1167742ea
+
+# ─── PostHog analytics ───────────────────────────────────────────────────────
+NEXT_PUBLIC_POSTHOG_PROJECT_TOKEN=your_posthog_project_token_here
+NEXT_PUBLIC_POSTHOG_HOST=https://us.i.posthog.com

instrumentation-client.ts

@@ -0,0 +1,21 @@
+import posthog from "posthog-js";
+
+const projectToken = process.env.NEXT_PUBLIC_POSTHOG_PROJECT_TOKEN;
+const host = process.env.NEXT_PUBLIC_POSTHOG_HOST;
+
+if (!projectToken || !host) {
+  if (process.env.NODE_ENV !== "production") {
+    throw new Error(
+      !projectToken
+        ? "NEXT_PUBLIC_POSTHOG_PROJECT_TOKEN variable required by PostHog is missing or un-configured, this causes events to be silently missed. This error stops appearing once NEXT_PUBLIC_POSTHOG_PROJECT_TOKEN is configured"
+        : "NEXT_PUBLIC_POSTHOG_HOST variable required by PostHog is missing or un-configured, this causes events to be silently missed. This error stops appearing once NEXT_PUBLIC_POSTHOG_HOST is configured",
+    );
+  }
+} else {
+  posthog.init(projectToken, {
+    api_host: host,
+    defaults: "2026-01-30",
+    capture_exceptions: true,
+    debug: process.env.NODE_ENV === "development",
+  });
+}

package.json

@@ -16,6 +16,7 @@
     "lucide-react": "^1.14.0",
     "next": "^16.2.5",
     "postcss": "^8.5.15",
+    "posthog-js": "^1.410.6",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "rehype-raw": "^7.0.0",

src/components/copy-command.tsx

@@ -1,6 +1,7 @@
 "use client";
 
 import { Check, Copy } from "lucide-react";
+import posthog from "posthog-js";
 import { useEffect, useRef, useState } from "react";
 
 type CopyStatus = "idle" | "copied" | "failed";
@@ -32,6 +33,12 @@ export function CopyCommand({ value }: { value: string }) {
 
         try {
           await navigator.clipboard.writeText(value);
+          if (
+            process.env.NEXT_PUBLIC_POSTHOG_PROJECT_TOKEN &&
+            process.env.NEXT_PUBLIC_POSTHOG_HOST
+          ) {
+            posthog.capture("command_copied");
+          }
           setStatus("copied");
         } catch {
           setStatus("failed");

src/components/node-info-checker.tsx

@@ -2,6 +2,7 @@
 
 import { useState } from "react";
 import { AlertTriangle, CheckCircle2, Eraser, Search } from "lucide-react";
+import posthog from "posthog-js";
 
 type Tone = "good" | "warn" | "bad" | "idle";
 
@@ -167,6 +168,12 @@ export function NodeInfoChecker() {
                 });
                 return;
               }
+              if (
+                process.env.NEXT_PUBLIC_POSTHOG_PROJECT_TOKEN &&
+                process.env.NEXT_PUBLIC_POSTHOG_HOST
+              ) {
+                posthog.capture("node_info_analyzed");
+              }
               setResult(classifyInfo(trimmed));
             }}
             type="button"