StackSee Analytics
Providers

PostHog Provider

Product analytics with feature flags and session replay

PostHog is an open-source product analytics platform with powerful features like feature flags, session replay, and advanced analytics.

Installation

pnpm install @stacksee/analytics posthog-js posthog-node

Client-Side Usage

import { createClientAnalytics } from '@stacksee/analytics/client';
import { PostHogClientProvider } from '@stacksee/analytics/providers/client';

const analytics = createClientAnalytics({
  providers: [
    new PostHogClientProvider({
      token: 'your-posthog-project-api-key',
      api_host: 'https://app.posthog.com', // optional
      debug: false
    })
  ]
});

await analytics.initialize();

Server-Side Usage

import { createServerAnalytics } from '@stacksee/analytics/server';
import { PostHogServerProvider } from '@stacksee/analytics/providers/server';

const serverAnalytics = createServerAnalytics({
  providers: [
    new PostHogServerProvider({
      apiKey: process.env.POSTHOG_API_KEY!,
      host: 'https://app.posthog.com',
      flushAt: 20,
      flushInterval: 10000
    })
  ]
});

// Track events
await serverAnalytics.track('user_signed_up', {
  userId: 'user-123',
  plan: 'pro'
}, {
  userId: 'user-123'
});

// Always shutdown to flush events
await serverAnalytics.shutdown();

Configuration Options

The PostHogClientProvider accepts all PostHog JS SDK options. See the PostHog docs for details.

Resources