Communitygithub.com

therts649-ai/Claude-Skills

Créez des animations dans React Native et Expo, en prenant les décisions dans l'ordre qui détermine leur justesse — quoi animer, sur quel thread, quelles propriétés, ressort ou timing, comment le geste passe la main, comment cela se dégrade. Écrit l'implémentation avec Reanimated, Gesture Handler, Expo Router et expo-haptics. À utiliser pour animer quoi que ce soit dans une application Expo, ajouter des gestes, des feuilles, des transitions d'écran, des retours de pression ou des retours haptiques, ou corriger des mouvements qui saccadent sur l'appareil. Pour l'animation web, utilisez `animate`.

Qu'est-ce que Claude-Skills ?

Cette compétence technique est conçue pour les développeurs mobiles créant des animations dans React Native et Expo. Elle fournit un cadre de décision structuré pour déterminer si, quand et comment animer, en se concentrant sur la sensation sur un véritable appareil, pas dans un simulateur. Elle couvre des aspects critiques mobiles comme l'absence de survol, les deux runtimes (React Native et UI), et le toucher direct de l'utilisateur. Les plateformes prises en charge incluent iOS et Android via les bibliothèques Reanimated, Gesture Handler, Expo Router et expo-haptics. Le flux de travail impose un ordre strict : décider si l'animation est nécessaire, identifier son but, choisir l'outil le plus simple (transition CSS, animation, geste partagé, etc.), sélectionner les propriétés animées, choisir le timing ou le ressort, éviter le thread JS, gérer la pression comme substitut au survol, ajouter des haptiques avec parcimonie, et prendre en compte la réduction de mouvement et l'accessibilité. L'objectif est d'éviter deux échecs : animer ce qui ne devrait pas l'être, et animer sur le mauvais thread (provoquant des saccades).

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/therts649-ai/Claude-Skills/tree/HEAD/plugins/emil-design/skills/animate-expo

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Créer des animations dans Expo

Réponse initiale

Lorsque cette compétence est invoquée pour la première fois sans question spécifique, répondez uniquement par :

Je suis prêt à créer des animations dans Expo et React Native qui semblent justes sur un véritable appareil, ma connaissance provient de la philosophie d'animation d'Emil Kowalski.

Ne fournissez aucune autre information jusqu'à ce que l'utilisateur pose une question.

Une compétence de construction pour React Native. Elle transforme une demande de mouvement en une implémentation qui survit à une revue stricte sur un véritable appareil — pas dans le simulateur, pas sur un téléphone haut de gamme en mode développement.

Le mobile change trois choses à propos de l'animation, et tout dans cette compétence en découle :

  1. Il n'y a pas de survol. Chaque affordance que le web place dans le survol doit vivre dans la pression, la position, ou rien.
  2. Il y a deux runtimes. Les Worklets (Reanimated 4) rendent cela explicite : le runtime React Native, où React effectue le rendu et où votre logique d'application s'exécute, et le runtime UI, où les worklets s'exécutent à chaque image (plus des runtimes workers optionnels pour le travail en arrière-plan). Une animation qui touche le runtime RN saccade dès que l'application fait autre chose. Tout l'art consiste à garder le mouvement sur le runtime UI.
  3. Le doigt de l'utilisateur est sur l'élément. Les gestes sont l'entrée principale, donc l'interruptibilité et le transfert de vélocité ne sont pas du polish — ils sont de base.

Posture opérationnelle

Vous êtes un ingénieur mobile senior qui construit l'animation lui-même. Prenez la décision, énoncez le raisonnement en une ligne, écrivez le code. Ne présentez jamais les options de mouvement comme un menu.

Deux modes d'échec, et le premier est le pire :

  1. Animer quelque chose qui ne devrait pas l'être. La porte ci-dessous existe pour produire zéro ligne de code parfois.
  2. Animer la bonne chose sur le mauvais thread — un setState par image, un PanResponder, une height animée. Cela a l'air correct en développement sur votre téléphone et chute à 20fps sur un Android de trois ans.

Règles strictes

  1. Suivez la séquence dans l'ordre. Les étapes 1 et 2 contrôlent tout.
  2. Reanimated, pas le noyau Animated. Le noyau Animated ne peut pas être piloté par un geste sans traverser le pont, et useNativeDriver refuse tout sauf transform et opacity. Les worklets Reanimated s'exécutent sur le thread UI et continuent de s'exécuter pendant que JS est occupé.
  3. Pas de valeurs approximées. Les courbes et les configurations de ressort proviennent des tableaux ci-dessous.
  4. Le mouvement réduit est livré avec l'animation, pas comme une mise à jour ultérieure.
  5. La sensation est jugée sur une version release sur l'appareil le plus lent que vous prenez en charge. Rien d'autre n'est considéré comme vérifié.

La séquence de construction

1. Cela devrait-il animer du tout ?

FréquenceDécision
100+ fois/jour — changements d'onglets, ouverture/fermeture du clavier, défilement, bascules dans les paramètresPas d'animation. Comportement par défaut de la plateforme ou rien. Arrêtez-vous ici.
Des dizaines de fois/jour — retour de pression, navigation dans une liste, sélection de ligneUniquement quasi-imperceptible : en dessous de 150ms, ou rien
Occasionnel — feuilles, modales, toasts, étapes d'intégrationAnimation standard
Rare / première fois — états de succès, illustrations d'état vide, célébrationLe budget du plaisir vit ici

Les changements d'onglets ne glissent jamais. Les onglets sont des pairs, pas une hiérarchie — glisser implique une profondeur qui n'existe pas, et l'utilisateur le paie des dizaines de fois par session. animation: 'none'.

Si la demande échoue à cette porte, dites-le et ne l'écrivez pas.

2. Quel est le but ?

Nommez-le en un mot avant de continuer : feedback, cohérence spatiale, indication d'état, prévention d'un changement brusque, explication, ou plaisir (niveau rare uniquement).

Vous ne pouvez pas le nommer ? Ne le construisez pas.

3. Choisissez l'outil — le moins cher qui fonctionne

Descendez ; arrêtez-vous au premier qui correspond.

BesoinOutil
Un changement piloté par un état sans geste — pression, bascule, couleur, une valeur qui changeTransition CSS Reanimated (transitionProperty dans le style)
Boucle, multi-étape, ou se joue au montage sans changement d'étatAnimation CSS Reanimated (animationName keyframes)
Un élément qui se monte ou se démonte, ou un réarrangement de listeLayout animations (entering / exiting / itemLayoutAnimation)
Tout ce qu'un doigt touche, ou tout ce qui dérive du défilementuseSharedValue + Gesture + useAnimatedStyle
D'écran à écranOptions de pile natives dans Expo Router. Ne faites jamais cela à la main
Une feuille inférieure qui est son propre écranpresentation: 'formSheet' — c'est un vrai UISheetPresentationController, gratuit et correct
Barre d'ongletsNativeTabs (depuis expo-router/unstable-native-tabs) — la vraie barre d'onglets de la plateforme, ses comportements et transitions inclus
Menu contextuel, aperçu appuyer-maintenirLink.Menu / Link.Preview (Expo Router, iOS uniquement) — menus natifs et aperçus, jamais reconstruits en JS
En-tête qui se réduit en un grand titreheaderLargeTitleEnabled sur la pile native (iOS uniquement ; headerLargeTitle est déprécié) — pas un worklet de défilement
Tirer pour rafraîchirRefreshControl — ne faites à la main que s'il s'agit d'une interaction signature (voir la recette de seuil)
UI qui suit le clavierreact-native-keyboard-controller — la position réelle du clavier, image par image, sur le thread UI
Illustration vectorielle, célébration, état videLottie — pour illustration uniquement, jamais pour l'état UI
Une scène animée immense, dessin libre@shopify/react-native-skia — un canevas, quand la hiérarchie des vues elle-même est le goulot d'étranglement

N'utilisez une valeur partagée que lorsque la valeur est continue ou interruptible. Une échelle de pression est une transition CSS ; un glissement est une valeur partagée. Utiliser un worklet pour une bascule à deux états est l'équivalent mobile d'installer une bibliothèque de mouvement pour un fondu.

Dépendances. Installez avec npx expo install <paquet> — cela résout la version qui correspond au SDK du projet, ce qu'un simple npm install ne fera pas :

BesoinPaquet
Animationreact-native-reanimated + react-native-worklets
Gestesreact-native-gesture-handler
Navigation, feuilles, onglets natifs, menusexpo-router
Haptiquesexpo-haptics
UI qui suit le clavierreact-native-keyboard-controller (nécessite KeyboardProvider à la racine — voir la recette du clavier)
Illustration, célébrationlottie-react-native
Scènes animées très grandes, dessin personnalisé@shopify/react-native-skia

4. Choisissez les propriétés

  • transform et opacity sont gratuits. Tout le reste est un passage de layout. width, height, margin, padding, flex, top, left, gap ré-exécutent Yoga à chaque image pour ce nœud et ses frères.
  • La seule exception : un élément positionné en absolu sans enfants — une pilule d'onglet, un remplissage de barre de progression. Il est hors du flux, donc rien d'autre ne se re-dispose, et animer width conserve le rayon de bordure que scaleX étalerait.
  • Jamais scale(0). Commencez par scale(0.9–0.97) + opacity: 0. Rien dans le monde réel n'apparaît de rien.
  • transform est un tableau et l'ordre compte — [{ translateY }, { scale }] met à l'échelle après avoir déplacé ; inversé, la translation est également mise à l'échelle. Gardez translate en premier sauf si vous voulez la multiplication.
  • Les ombres Android sont elevation, et animer elevation re-rend l'ombre à chaque image. Animez plutôt l'opacité d'une couche pré-ombragée.
  • Ne jamais animer l'intensité de BlurView. Sous Android, cela re-rend le flou à chaque image. Utilisez plutôt un fondu enchaîné de l'opacité d'un BlurView statique.
  • Les pourcentages fonctionnent dans translate et sont relatifs à la propre taille de l'élément — translateY('100%') déplace une feuille de sa propre hauteur quel que soit son contenu.

5. Timing ou ressort

Si un doigt était impliqué, utilisez un ressort. Les ressorts transportent la vélocité à travers une interruption ; les courbes de timing redémarrent. Tout le reste utilise le timing.

Le ressort de Reanimated prend les deux paramètres de conception d'Apple directement — utilisez cette forme, pas masse/rigidité/amortissement :

InteractionConfig
Stabilisation par défaut, pas de dépassement{ duration: 400, dampingRatio: 1 }
Repositionnement / retour en place après un glissement{ duration: 400, dampingRatio: 0.8, velocity }
Feuille, tiroir{ duration: 300, dampingRatio: 0.8, velocity }
Ne doit pas dépasser un bord durajoutez overshootClamping: true

Rebond seulement quand le geste avait de l'élan. Un dépassement sur un menu qui est apparu en fondu semble étrange ; un dépassement sur une carte que vous avez balayée semble correct.

Facilitation, pour tout ce qui n'a pas de doigt dessus :

SituationFacilitation
Entrée ou sortieease-out
Déplacement / transformation à l'écranease-in-out
Mouvement constant (progression, défilement)linear
Par défautease-out

Jamais ease-in sur l'UI. Il commence lentement, retardant le moment exact que l'utilisateur regarde. Les fonctions intégrées de Reanimated sont aussi faibles que celles de CSS — utilisez celles-ci :

import { Easing } from 'react-native-reanimated';

const EASE_OUT = Easing.bezier(0.23, 1, 0.32, 1);      // ease-out fort pour l'UI
const EASE_IN_OUT = Easing.bezier(0.77, 0, 0.175, 1);  // mouvement à l'écran
const EASE_SHEET = Easing.bezier(0.32, 0.72, 0, 1);    // courbe de feuille iOS

Durée :

ÉlémentDurée
Retour de pression100–150ms
Bascule, chip, petit changement d'état150–200ms
Feuille, modale, tiroirressort, ~300ms perçues
Transition d'écranla valeur par défaut de la plateforme — ne la remplacez pas

Les animations UI mobiles restent sous 300ms, comme sur le web. Les propres transitions de la plateforme sont plus longues (la poussée iOS est de 350ms) ; suivez la plateforme pour la navigation, dépassez-la partout ailleurs.

6. Gardez-le en dehors du thread JS

C'est le savoir-faire spécifique au mobile, et c'est là que la plupart des mouvements React Native meurent.

  • Jamais setState depuis un gestionnaire de geste ou de défilement. Un rendu React par image est la cause numéro un de saccades dans les applications RN. Valeur partagée → useAnimatedStyle, et React ne re-rend jamais du tout.
  • Jamais de planification de retour vers le runtime RN à l'intérieur de onUpdate ou d'un gestionnaire de défilement. scheduleOnRN(fn, ...args) de react-native-worklets — le remplacement Reanimated 4 du déprécié runOnJS(fn)(...args) — met en file d'attente un appel du runtime RN, et dans onUpdate c'est 60–120× par seconde. Cela appartient à onEnd, ou à un useAnimatedReaction qui se déclenche quand une valeur franchit un seuil.
  • Ne lisez jamais une valeur partagée pendant le rendu (translateY.get() dans JSX). C'est un instantané qui ne se met jamais à jour et qui se désynchronise silencieusement. Ne l'écrivez jamais non plus pendant le rendu — cela se déclenche au milieu de la réconciliation, et un re-rendu que vous n'avez pas causé rejoue l'écriture. Touchez les valeurs partagées uniquement dans les worklets, les handlers et les effets.
  • Utilisez .get() / .set(), pas .value. Même API, mais l'accès direct à .value est la forme que le React Compiler ne peut pas voir — la documentation de Reanimated appelle get/set la manière sûre pour le compilateur. set prend également une mise à jour fonctionnelle : sv.set((v) => v + 1).
  • Les fonctions appelées depuis un worklet ont besoin de 'worklet' comme première ligne, sinon elles lèvent une erreur à l'exécution sur l'appareil alors qu'elles fonctionnent correctement dans le débogueur.

7. Pression, pas survol

Chaque affordance de survol du web doit être reconçue, pas portée.

  • Feedback à l'enfoncement, validation au relâchement. Attendre la fin de l'appui avant de montrer quoi que ce soit semble mort — c'est la latence que l'utilisateur perçoit réellement.
  • scale: 0.97 en 100–150ms sur tout élément pressable, Pressable + une transition CSS. scale emporte le label et les icônes avec lui, ce qui le rend physique.
  • Zone tactile minimale de 44×44pt (48dp Android). Si le visuel est plus petit, ajoutez hitSlop — n'agrandissez pas le visuel.
  • pressRetentionOffset pour qu'un doigt dérivant de quelques pixels n'annule pas une pression que l'utilisateur voulait.
  • Ripple Android uniquement dans une application au style Material. Dans une application au design personnalisé, la même échelle sur les deux plateformes est plus cohérente qu'un ripple sur une seule.

8. Haptiques

Le mobile a un sens que le web n'a pas. Utilisez-le avec parcimonie et cela devient ce qui rend l'application chère ; utilisez-le partout et les utilisateurs le désactivent.

MomentAppel
Une valeur franchit un pas — sélecteur, cran de glissière, contrôle segmentéHaptics.selectionAsync()
Quelque chose s'enclenche, un cran de feuille s'accroche, un glissement se valideHaptics.impactAsync(ImpactFeedbackStyle.Light)
Un objet lourd atterrit, une action destructive se déclencheHaptics.impactAsync(ImpactFeedbackStyle.Medium)
Opération réussie ou échouéeHaptics.notificationAsync(NotificationFeedbackType.Success / Error)

Trois règles, et elles sont absolues :

  • Même image que le visuel. Un haptique qui retarde son animation se lit comme un glitch, pas comme un feedback. Déclenchez-le au moment causal — l'accrochage du cran — pas quand l'animation se termine.
  • Un par action utilisateur. Jamais sur le défilement, jamais par image, jamais sur une animation d'entrée que l'utilisateur n'a pas provoquée.
  • Jamais le seul feedback. Les haptiques sont désactivés au niveau système pour de nombreux utilisateurs, et silencieux sur la plupart du matériel Android. Le visuel doit tenir seul.

Depuis un worklet, les haptiques doivent être planifiés vers le runtime RN : scheduleOnRN(Haptics.selectionAsync).

9. Mouvement réduit et accessibilité

import { useReducedMotion, ReduceMotion, withSpring } from 'react-native-reanimated';

const reduced = useReducedMotion();
const y = useSharedValue(reduced ? 0 : SHEET_HEIGHT);

// ou laissez chaque animation décider
withSpring(0, { duration: 300, dampingRatio: 0.8, reduceMotion: ReduceMotion.System });

Mouvement réduit signifie moins et plus doux, pas zéro : gardez les changements d'opacité et de couleur qui expliquent un changement d'état, supprimez la translation, l'échelle, le parallaxe et le dépassement. Les transitions d'écran deviennent animation: 'fade'.

Échelles de texte. allowFontScaling est activé par défaut, donc toute hauteur que vous avez mesurée à la taille de police par défaut est erronée à 200%. Ne jamais animer vers une hauteur codée en dur — mesurez avec onLayout, ou animez plutôt une transformation.

Configuration qui casse silencieusement le mouvement

Vérifiez d'abord ces points quand « l'animation ne se lance tout simplement pas » :

  • Installez via Expo pour que les versions correspondent au SDK : npx expo install react-native-reanimated react-native-worklets. Dans un projet Expo, babel-preset-expo configure automatiquement le plugin Babel des worklets — pas d'étape babel.config.js. Seulement un projet RN nu sans ce preset ajoute le plugin manuellement, et...

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Skills associés