posthog-deploy-integration

Skill do wdrażania PostHog na popularne platformy hostingowe. Obsługuje Next.js z reverse proxy na Vercel (omijanie blokerów reklam), samodzielnie hostowaną instancję PostHog w Dockerze oraz wdrażanie na Google Cloud Run. Automatyzuje konfigurację zmiennych środowiskowych, ustawienie kluczy API oraz pipelines deploymentu. Idealny dla zespołów, które chcą szybko uruchomić analitykę zdarzeń w produkcji bez ręcznej konfiguracji platform.

1. Upewnij się, że masz zainstalowane CLI wymagane dla Twojej platformy: vercel dla Vercel, docker dla samodzielnego hostowania, lub gcloud dla Cloud Run. Przygotuj klucze PostHog: publiczny klucz projektu (phc_...) i osobisty klucz API (phx_...) ze swojego konta PostHog.

2. Wyzwól skill frazą taką jak "deploy posthog", "posthog Vercel", "posthog production deploy", "posthog Cloud Run", "posthog self-hosted" lub "posthog Docker". Skill automatycznie rozpozna Twoją platformę docelową.

3. Dla wdrożenia Next.js na Vercel: skill doda zmienne środowiskowe (NEXT_PUBLIC_POSTHOG_KEY, NEXT_PUBLIC_POSTHOG_HOST, POSTHOG_PERSONAL_API_KEY, POSTHOG_PROJECT_ID) do konfiguracji produkcyjnej. Skonfiguruje reverse proxy w next.config.js, który omija blokery reklam poprzez kierowanie żądań przez Twój własny endpoint /ingest.

4. Skill zaktualizuje plik providers.tsx (lub app.tsx) aby zainicjalizować klienta PostHog po stronie klienta z prawidłowym hostem proxy. Zapewni to, że zdarzenia będą wysyłane przez Twój serwer, a nie bezpośrednio z przeglądarki.

5. Dla samodzielnego hostowania lub Cloud Run: skill wygeneruje niezbędne pliki konfiguracyjne Dockera i ustawienia środowiska specyficzne dla wybranej platformy. Wdroży instancję PostHog i skonfiguruje połączenie z Twoją aplikacją.

6. Po wdrożeniu zweryfikuj połączenie logując się do panelu PostHog i sprawdzając, czy zdarzenia z Twojej aplikacji są rejestrowane. Skill może również uruchomić testy deploymentu na wybranej platformie.