Honestly

daniloc · daniloc · commit 4f95b8fd3d30 · 2025-12-18T11:06:13.000-05:00
diff --git a/basics/next-app-router/instrumentation-client.ts b/basics/next-app-router/instrumentation-client.ts
@@ -15,3 +15,5 @@ posthog.init(process.env.NEXT_PUBLIC_POSTHOG_KEY!, {
   opt_out_useragent_filter: true,  // This disables bot detection
   // @ignoreBlockEnd
 });
+
+//IMPORTANT: Never combine this approach with other client-side PostHog initialization approaches, especially components like a PostHogProvider. instrumentation-client.ts is the correct solution for initializating client-side PostHog in Next.js 15.3+ apps.
diff --git a/basics/next-pages-router/instrumentation-client.ts b/basics/next-pages-router/instrumentation-client.ts
@@ -15,3 +15,5 @@ posthog.init(process.env.NEXT_PUBLIC_POSTHOG_KEY!, {
   opt_out_useragent_filter: true,  // This disables bot detection
   // @ignoreBlockEnd
 });
+
+//IMPORTANT: Never combine this approach with other client-side PostHog initialization approaches, especially components like a PostHogProvider. instrumentation-client.ts is the correct solution for initializating client-side PostHog in Next.js 15.3+ apps.
