Intégration PostHog pour React Router v7 - Mode données

Cette skill vous aide à ajouter PostHog analytics à vos applications React Router v7 - Mode données.

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 React Router v7 - Mode données
• references/react-router-v7-data-mode.md - Documentation React Router v7 mode données
• references/identify-users.md - Identifier les utilisateurs - docs
• 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 motif d'implémentation cible. Consultez la documentation pour les détails de l'API.

Principes clés

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

Directives du framework

• Pour les feature flags, utilisez les hooks useFeatureFlagEnabled() ou useFeatureFlagPayload() - ils gèrent les états de chargement et la synchronisation externe automatiquement
• Ajoutez la capture d'analytics dans les gestionnaires d'événements où les actions utilisateur se produisent, PAS dans useEffect en réaction aux changements d'état
• N'utilisez PAS useEffect pour la transformation de données - calculez les valeurs dérivées lors du rendu à la place
• N'utilisez PAS useEffect pour réagir aux événements utilisateur - mettez cette logique directement dans le gestionnaire d'événement
• N'utilisez PAS useEffect pour chaîner les mises à jour d'état - calculez toutes les mises à jour associées ensemble dans le gestionnaire d'événement
• N'utilisez PAS useEffect pour notifier les composants parents - appelez la callback du parent aux côtés de setState dans le gestionnaire d'événement
• Pour réinitialiser l'état du composant quand une prop change, passez la prop comme clé du composant plutôt que d'utiliser useEffect
• useEffect est UNIQUEMENT pour la synchronisation avec les systèmes externes (widgets non-React, APIs navigateur, souscriptions réseau)

Identifier les utilisateurs

Identifiez les utilisateurs lors des événements de connexion et inscription. Reportez-vous au code exemple et à la documentation pour le motif identify correct pour ce framework. Si du code frontend et backend existe, passez 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, particulièrement autour des flux utilisateur critiques et aux limites des API.