feat: integrate PostHog for analytics + instrumentation

Author: polarhive

.env.example

@@ -11,4 +11,7 @@ NEXTAUTH_SECRET=xxxx
 ADMIN_EMAIL=[email protected]
 TURSO_DATABASE_URL=libsql://<your-db-url>
 GOOGLE_CLIENT_ID=xxxx.apps.googleusercontent.com
-NEXTAUTH_URL=https://your-site.example
+NEXTAUTH_URL=https://your-site.example
+
+# analytics (posthog)
+POSTHOG_UI_HOST=https://eu.posthog.com

README.md

@@ -1,6 +1,6 @@
-# eloop-turso — Serverless Event Management
+# eloop by HSP — Event Management Platform
 
-eloop is an event management system that integrates with Turso (DBaaS), supporting hierarchical roles and dynamic form generation.
+Eventloop (eloop) is a serverless event management app built with Next.js and Turso. It supports hierarchical roles, dynamic registration forms, and QR-based check-ins.
 
 [![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fpolarhive%2Feloop-serverless-spin&env=QR_SECRET,GOOGLE_CLIENT_SECRET,TURSO_AUTH_TOKEN,NEXTAUTH_SECRET,ADMIN_EMAIL,TURSO_DATABASE_URL,GOOGLE_CLIENT_ID,NEXTAUTH_URL)
 
@@ -19,7 +19,7 @@ The project reads configuration from environment variables. See the shipped `.en
 - `QR_SECRET` — secret used to sign QR payloads
 - `TURSO_DATABASE_URL` — your Turso/libSQL connection URL (libsql://...)
 - `TURSO_AUTH_TOKEN` — Turso service token used to access the database
-
+- `POSTHOG_KEY=phc_xxx` Uses PostHog for instrumentation
 
 ## Google OAuth Client Setup
 

instrumentation-client.ts

@@ -0,0 +1,10 @@
+import posthog from "posthog-js"
+
+posthog.init(process.env.POSTHOG_KEY!, {
+  api_host: "/blob",
+  ui_host: process.env.POSTHOG_UI_HOST || "https://eu.posthog.com",
+  defaults: '2025-05-24',
+  person_profiles: 'always',
+  capture_exceptions: true, // This enables capturing exceptions using Error Tracking, set to false if you don't want this
+  debug: process.env.NODE_ENV === "development",
+})

next.config.ts

@@ -17,9 +17,34 @@ const nextConfig: NextConfig = {
 
   // Disable ESLint for production build
   eslint: {
-    // Only run ESLint in development
     ignoreDuringBuilds: true,
-  }
+  },
+  
+  async rewrites() {
+    const posthogUiHost = process.env.POSTHOG_UI_HOST || "https://eu.posthog.com"
+
+    const posthogAssetsHost =
+      process.env.POSTHOG_UI_HOST ||
+      (posthogUiHost.includes("eu.posthog") ? "https://eu-assets.i.posthog.com" : "https://us-assets.i.posthog.com")
+
+    const posthogApiHost =
+      process.env.POSTHOG_UI_HOST ||
+      (posthogUiHost.includes("eu.posthog") ? "https://eu.i.posthog.com" : "https://us.i.posthog.com")
+
+    return [
+      {
+        source: "/blob/static/:path*",
+        destination: `${posthogAssetsHost}/static/:path*`,
+      },
+      {
+        source: "/blob/:path*",
+        destination: `${posthogApiHost}/:path*`,
+      },
+    ];
+  },
+
+  // This is required to support PostHog trailing slash API requests
+  skipTrailingSlashRedirect: true,
 };
 
 export default nextConfig;

package-lock.json

@@ -23,6 +23,8 @@
     "lucide-react": "^0.544.0",
     "next": "15.5.4",
     "next-auth": "^5.0.0-beta.29",
+    "posthog-js": "^1.275.1",
+    "posthog-node": "^5.9.5",
     "qrcode": "^1.5.4",
     "qrcode.react": "^4.2.0",
     "react": "19.1.0",