feat(docs): add PostHog analytics with reverse proxy

Set up posthog-js with instrumentation-client.ts for privacy-friendly
product analytics. Route events through /ingest/* reverse proxy to
bypass ad blockers. Env vars configured in Vercel dashboard.

Author: Rednegniw

bun.lock

@@ -0,0 +1,2 @@
+NEXT_PUBLIC_POSTHOG_KEY=phc_your_project_api_key_here
+NEXT_PUBLIC_POSTHOG_HOST=https://us.i.posthog.com

docs/.env.example

@@ -21,6 +21,7 @@ yarn-debug.log*
 yarn-error.log*
 
 # others
+.env
 .env*.local
 .vercel
 next-env.d.ts

docs/.gitignore

@@ -5,12 +5,23 @@ const withMDX = createMDX();
 /** @type {import('next').NextConfig} */
 const config = {
   reactStrictMode: true,
+  skipTrailingSlashRedirect: true,
   async rewrites() {
     return [
       {
         source: '/docs/:path*.mdx',
         destination: '/llms.mdx/docs/:path*',
       },
+
+      // PostHog reverse proxy
+      {
+        source: '/ingest/static/:path*',
+        destination: 'https://us-assets.i.posthog.com/static/:path*',
+      },
+      {
+        source: '/ingest/:path*',
+        destination: 'https://us.i.posthog.com/:path*',
+      },
     ];
   },
 };

docs/next.config.mjs

@@ -19,6 +19,7 @@
     "lucide-react": "^0.563.0",
     "motion": "^12.34.1",
     "next": "16.1.6",
+    "posthog-js": "^1.350.0",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "tailwind-merge": "^3.4.0"

docs/package.json

@@ -0,0 +1,10 @@
+import posthog from 'posthog-js'
+
+posthog.init(process.env.NEXT_PUBLIC_POSTHOG_KEY!, {
+  api_host: '/ingest',
+  ui_host: 'https://us.posthog.com',
+  capture_pageview: true,
+  capture_pageleave: true,
+  capture_exceptions: true,
+  debug: process.env.NODE_ENV === 'development',
+})