PostHog Integration

1$# .env.local
2$NEXT_PUBLIC_POSTHOG_KEY="phc_your_key"  # Optional
3$NEXT_PUBLIC_POSTHOG_HOST="https://us.i.posthog.com"  # Optional
4
5$# If not set, PostHog won't initialize (no errors)
6$# App works perfectly without analytics

1"use client";
2
3import { trackEvent } from "@/lib/analytics/posthog-provider";
4
5export default function DashboardButton() {
6  const handleClick = () => {
7    // Safe tracking - no-op if PostHog not configured
8    trackEvent("dashboard_button_clicked", {
9      button: "export_data",
10      location: "analytics_page",
11    });
12  };
13
14  return <button onClick={handleClick}>Export</button>;
15}

1// Use safe helper functions from events.ts
2import { trackUserSignup, trackOrgCreated } from "@/lib/analytics/events";
3
4// Track user signup
5await trackUserSignup(userId, email, {
6  provider: "google",
7});
8
9// Track organization creation
10await trackOrgCreated(userId, orgId, "My Org", {
11  memberCount: 1,
12});

1// PostHogProvider automatically tracks pageviews
2// Already integrated in src/app/layout.tsx
3
4import { PostHogProvider } from "@/lib/analytics/posthog-provider";
5
6export default function RootLayout({ children }) {
7  return (
8    <PostHogProvider>
9      {children}  {/* Pageviews tracked on route change */}
10    </PostHogProvider>
11  );
12}