Intégration PostHog pour SvelteKit

Cette skill vous aide à ajouter PostHog analytics à vos applications SvelteKit.

Workflow

Suivez ces étapes dans l'ordre pour compléter l'intégration :

1. basic-integration-1.0-begin.md - Configuration PostHog - Début ← Commencez ici
2. basic-integration-1.1-edit.md - Configuration PostHog - Édition
3. basic-integration-1.2-revise.md - Configuration PostHog - Révision
4. basic-integration-1.3-conclude.md - Configuration PostHog - Conclusion

Fichiers de référence

• references/EXAMPLE.md - Code du projet exemple SvelteKit
• references/svelte.md - Svelte - documentation
• references/identify-users.md - Identifier les utilisateurs - documentation
• references/basic-integration-1.0-begin.md - Configuration PostHog - début
• references/basic-integration-1.1-edit.md - Configuration PostHog - édition
• references/basic-integration-1.2-revise.md - Configuration PostHog - révision
• references/basic-integration-1.3-conclude.md - Configuration PostHog - conclusion

Le projet exemple montre le modèle d'implémentation cible. Consultez la documentation pour les détails de l'API.

Principes clés

• Variables d'environnement : Utilisez toujours les variables d'environnement pour les clés PostHog. Ne les codez jamais en dur.
• Changements minimalistes : Ajoutez le code PostHog aux côtés des intégrations existantes. Ne remplacez ni ne restructurez le code existant.
• Suivez l'exemple : Votre implémentation doit suivre les modèles du projet exemple aussi étroitement que possible.

Directives pour le framework

• Définissez paths.relative à false dans svelte.config.js — cela est requis pour que la relecture de session PostHog fonctionne correctement avec SSR et c'est facile à oublier
• Utilisez les outils du serveur MCP Svelte pour consulter la documentation Svelte (list-sections, get-documentation) et valider les composants (svelte-autofixer) — exécutez toujours svelte-autofixer sur les fichiers .svelte nouveaux ou modifiés avant de terminer

Identifier les utilisateurs

Identifiez les utilisateurs lors des événements de connexion et d'inscription. Consultez le code exemple et la documentation pour le modèle d'identification correct pour ce framework. Si du code frontend et backend existent tous les deux, transmettez la session côté client et l'ID distinct en utilisant les headers X-POSTHOG-DISTINCT-ID et X-POSTHOG-SESSION-ID pour maintenir la corrélation.

Suivi des erreurs

Ajoutez le suivi des erreurs PostHog aux fichiers pertinents, en particulier autour des flux utilisateur critiques et des limites de l'API.