posthog-local-dev-loop

Umożliwia skonfigurowanie lokalnego środowiska development dla integracji PostHog z trybem debugowania, mockowanymi testami jednostkowymi i osobnym projektem dev. Zamiast wysyłać zdarzenia do produkcji podczas pracy nad kodem, możesz testować event tracking i feature flagi w izolacji. Skill automatyzuje strukturę projektu, konfigurację zmiennych środowiskowych oraz setup testów z Vitest lub Jest. Idealny do szybkiej iteracji — zmień kod, zobacz wyniki natychmiast bez czekania na deployment.

1. Upewnij się, że masz zainstalowany Node.js 20+ oraz npm lub pnpm. Skill wymaga wcześniejszego ukończenia konfiguracji posthog-install-auth — jeśli jej nie masz, najpierw ją uruchom.

2. Przygotuj osobny projekt PostHog dla development (oddzielny od produkcji). Skopiuj klucz API z tego projektu — będzie potrzebny w zmiennych środowiskowych.

3. Wyzwól skill frazą taką jak "posthog dev setup", "posthog local development", "mock posthog" lub "test posthog". Skill utworzy strukturę katalogów (src/analytics, tests) oraz pliki konfiguracyjne.

4. Skill wygeneruje plik .env.local z szablonami zmiennych (NEXT_PUBLIC_POSTHOG_KEY, POSTHOG_HOST). Uzupełnij te wartości danymi z Twojego dev projektu PostHog.

5. W pliku src/analytics/posthog.ts skill skonfiguruje klienta PostHog z trybem debugowania — zdarzenia będą logowane do konsoli bez wysyłania do serwera. Możesz to zmienić, ustawiając enabled: false w opcjach, gdy chcesz testować z rzeczywistym dev projektem.

6. Skill przygotuje testy w tests/analytics.test.ts z mockowanym PostHog — uruchom je poleceniem npm test lub pnpm test. Teraz możesz pisać testy event tracking bez wpływu na dane w PostHog.