PostHog Multi-Environment Setup

config/
├── posthog/
│   ├── base.json           # Shared config
│   ├── development.json    # Dev overrides
│   ├── staging.json        # Staging overrides
│   └── production.json     # Prod overrides

base.json

{
  "timeout": 30000,
  "retries": 3,
  "cache": {
    "enabled": true,
    "ttlSeconds": 60
  }
}

development.json

{
  "apiKey": "${POSTHOG_API_KEY}",
  "baseUrl": "https://api-sandbox.posthog.com",
  "debug": true,
  "cache": {
    "enabled": false
  }
}

staging.json

{
  "apiKey": "${POSTHOG_API_KEY_STAGING}",
  "baseUrl": "https://api-staging.posthog.com",
  "debug": false
}

production.json

{
  "apiKey": "${POSTHOG_API_KEY_PROD}",
  "baseUrl": "https://api.posthog.com",
  "debug": false,
  "retries": 5
}

Environment Detection

// src/posthog/config.ts
import baseConfig from '../../config/posthog/base.json';

type Environment = 'development' | 'staging' | 'production';

function detectEnvironment(): Environment {
  const env = process.env.NODE_ENV || 'development';
  const validEnvs: Environment[] = ['development', 'staging', 'production'];
  return validEnvs.includes(env as Environment)
    ? (env as Environment)
    : 'development';
}

export function getPostHogConfig() {
  const env = detectEnvironment();
  const envConfig = require(`../../config/posthog/${env}.json`);

  return {
    ...baseConfig,
    ...envConfig,
    environment: env,
  };
}

Secret Management by Environment

Local Development

# .env.local (git-ignored)
POSTHOG_API_KEY=sk_test_dev_***

CI/CD (GitHub Actions)