Que fait Compétences React Native ?
Bonnes pratiques complètes pour les applications React Native et Expo. Contient des règles couvrant plusieurs catégories : performances, animations, motifs d'interface utilisateur et optimisations spécifiques à la plateforme.
Quand les appliquer
Consultez ces directives lorsque :
- Vous construisez des applications React Native ou Expo
- Vous optimisez les performances des listes et du défilement
- Vous implémentez des animations avec Reanimated
- Vous travaillez avec des images et des médias
- Vous configurez des modules natifs ou des polices
- Vous structurez des projets monorepo avec des dépendances natives
Catégories de règles par priorité
| Priorité | Catégorie | Impact | Préfixe |
|---|---|---|---|
| 1 | Performances des listes | CRITIQUE | list-performance- |
| 2 | Animation | HAUTE | animation- |
| 3 | Navigation | HAUTE | navigation- |
| 4 | Motifs d'interface utilisateur | HAUTE | ui- |
| 5 | Gestion d'état | MOYENNE | react-state- |
| 6 | Rendu | MOYENNE | rendering- |
| 7 | Monorepo | MOYENNE | monorepo- |
| 8 | Configuration | FAIBLE | fonts-, imports- |
Référence rapide
1. Performances des listes (CRITIQUE)
list-performance-virtualize- Utilisez FlashList pour les grandes listeslist-performance-item-memo- Mémoïsez les composants d'éléments de listelist-performance-callbacks- Stabilisez les références de callbackslist-performance-inline-objects- Évitez les objets de style en lignelist-performance-function-references- Extrayez les fonctions en dehors du rendulist-performance-images- Optimisez les images dans les listeslist-performance-item-expensive- Déplacez les traitements coûteux hors des élémentslist-performance-item-types- Utilisez des types d'éléments pour les listes hétérogènes
2. Animation (HAUTE)
animation-gpu-properties- Animez uniquement transform et opacityanimation-derived-value- Utilisez useDerivedValue pour les animations calculéesanimation-gesture-detector-press- Utilisez Gesture.Tap au lieu de Pressable
3. Navigation (HAUTE)
navigation-native-navigators- Utilisez les piles natives et les onglets natifs plutôt que les navigateurs JS
4. Motifs d'interface utilisateur (HAUTE)
ui-expo-image- Utilisez expo-image pour toutes les imagesui-image-gallery- Utilisez Galeria pour les boîtes à lumière d'imagesui-pressable- Utilisez Pressable plutôt que TouchableOpacityui-safe-area-scroll- Gérez les zones sécurisées dans les ScrollViewui-scrollview-content-inset- Utilisez contentInset pour les en-têtesui-menus- Utilisez les menus contextuels natifsui-native-modals- Utilisez les modales natives lorsque possibleui-measure-views- Utilisez onLayout, pas measure()ui-styling- Utilisez StyleSheet.create ou Nativewind
5. Gestion d'état (MOYENNE)
react-state-minimize- Minimisez les abonnements d'étatreact-state-dispatcher- Utilisez le motif de répartiteur pour les callbacksreact-state-fallback- Affichez un fallback au premier rendureact-compiler-destructure-functions- Déstructurez pour le compilateur Reactreact-compiler-reanimated-shared-values- Gérez les valeurs partagées avec le compilateur
6. Rendu (MOYENNE)
rendering-text-in-text-component- Enveloppez le texte dans des composants Textrendering-no-falsy-and- Évitez&&pour le rendu conditionnel
7. Monorepo (MOYENNE)
monorepo-native-deps-in-app- Conservez les dépendances natives dans le paquet de l'applicationmonorepo-single-dependency-versions- Utilisez des versions uniques dans tous les paquets
8. Configuration (FAIBLE)
fonts-config-plugin- Utilisez les plugins de configuration pour les polices personnaliséesimports-design-system-folder- Organisez les importations du système de designjs-hoist-intl- Hoistez la création d'objets Intl
Comment utiliser
Lisez les fichiers de règles individuels pour des explications détaillées et des exemples de code :
rules/list-performance-virtualize.md
rules/animation-gpu-properties.md
Chaque fichier de règle contient :
- Une brève explication de son importance
- Un exemple de code incorrect avec explication
- Un exemple de code correct avec explication
- Contexte supplémentaire et références
Document compilé complet
Pour le guide complet avec toutes les règles développées : AGENTS.md