integration-astro-hybrid

Astro hybrid rendering uses static generation by default while selectively enabling server-side rendering (SSR) for specific pages or API routes. This approach allows you to prerender most pages while dynamically processing server-side PostHog analytics events where needed.

Yes, you can track server-side events in Astro API routes. The integration guides capturing events from the server environment and tying sessions via headers to maintain a unified PostHog identity across both static and SSR pages.

Managing environment variables for PostHog in an Astro project involves setting up your API keys for both client and server usage. The integration provides guidelines for proper environment setup, ensuring the singleton PostHog client can securely access credentials across frontend and backend contexts.

Yes, PostHog error tracking works across both frontend and backend in Astro. The integration supports error tracking and user identification across both environments, ensuring exceptions and events are captured consistently within your hybrid rendering setup.

A key limitation when using PostHog with Astro static pages is the inability to capture server-side events without SSR enabled. You must selectively opt into server-side rendering on specific pages to ensure backend event tracking and API route integration function correctly.