Communitygithub.com

CharbelElBateh/personal-website

Construisez des animations dans React Native et Expo en prenant les décisions dans l'ordre qui détermine si elles sont correctes — doit-elle animer, sur quel thread elle s'exécute, quelles propriétés, ressort ou timing, comment le geste est pris en charge, comment elle se dégrade. Écrit l'implémentation avec Reanimated, Gesture Handler, Expo Router et expo-haptics. À utiliser lors de l'animation de quoi que ce soit dans une application Expo, de l'ajout de gestes, de feuilles, de transitions d'écran, de retour de pression ou de vibrations, ou de la correction de mouvements qui saccadent sur l'appareil. Pour les animations web, utilisez `animate`.

Qu'est-ce que personal-website ?

Cette compétence, intitulée « Construire des animations dans Expo », est un guide complet pour créer des animations fluides et réactives dans React Native et Expo, en se concentrant sur les performances réelles des appareils plutôt que sur les simulateurs. Elle est conçue pour les développeurs mobiles qui souhaitent maîtriser l'art de l'animation mobile, en traitant de sujets tels que l'exécution sur le thread UI (Worklets avec Reanimated), la gestion des gestes (Gesture Handler), et l'utilisation de dépendances comme expo-router et expo-haptics. L'approche est systématique : elle commence par décider si une animation est nécessaire, puis détermine son objectif, choisit l'outil le plus approprié (CSS transitions, animations, layouts, ou gestes continus), et enfin sélectionne les propriétés, le timing, et le ressort adéquats. Elle insiste sur le fait de ne jamais utiliser `setState` dans un handler de geste ou de défilement, et de toujours animer sur le thread UI pour éviter les ralentissements. La compétence inclut également des directives strictes sur l'utilisation des vibrations, la réduction de mouvement, et l'accessibilité, garantissant que l'animation est jugée sur une version release sur l'appareil le plus lent pris en charge.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CharbelElBateh/personal-website/tree/HEAD/.claude/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

Construire 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 à construire des animations dans Expo et React Native qui se sentent correctement sur un véritable appareil, mes connaissances proviennent 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 révision 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 existe deux runtimes. Worklets (Reanimated 4) rend cela explicite : le runtime React Native, où React effectue le rendu et votre logique d'application s'exécute, et le runtime UI, où les worklets s'exécutent à chaque image (plus des runtimes de travailleurs optionnels pour les tâches 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 un raffinement — ils sont la base.

Posture opérationnelle

Vous êtes un ingénieur mobile senior qui construit l'animation vous-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 être animé. 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 semble acceptable en développement sur votre téléphone et chute à 20fps sur un Android vieux de trois ans.

Règles strictes

  1. Exécutez la séquence dans l'ordre. Les étapes 1 et 2 régissent tout.
  2. Reanimated, pas le Animated de base. Le Animated de base ne peut pas être piloté par un geste sans traverser le pont, et useNativeDriver refuse tout sauf la transformation et l'opacité de toute façon. Les worklets Reanimated s'exécutent sur le thread UI et continuent de fonctionner 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 un suivi.
  5. La sensation est jugée sur une version release sur l'appareil le plus lent que vous supportez. 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'onglet, ouverture/fermeture du clavier, défilement, bascules dans les paramètresPas d'animation. Par défaut de la plateforme ou rien. Arrêtez ici.
Des dizaines de fois/jour — retour de pression, navigation dans les listes, sélection de ligneUniquement quasi-imperceptible : moins de 150ms, ou rien
Occasionnelle — feuilles, modales, toasts, étapes d'intégrationAnimation standard
Rare / première fois — états de succès, illustrations d'écran vide, célébrationLe budget de plaisir vit ici

Les changements d'onglet ne glissent jamais. Les onglets sont des pairs, pas une hiérarchie — glisser implique une profondeur qui n'existe pas, et l'utilisateur paie pour cela 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 convient.

BesoinOutil
Un changement piloté par l'état sans geste — pression, bascule, couleur, une valeur qui changeTransition CSS Reanimated (transitionProperty dans le style)
Boucle, multi-étape, ou joué au montage sans changement d'étatAnimation CSS Reanimated (animationName keyframes)
Un élément qui se monte ou se démonte, ou une liste qui se réorganiseAnimations de disposition (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 native dans Expo Router. Ne faites jamais cela à la main
Une feuille inférieure qui est son propre écranpresentation: 'formSheet' — c'est un véritable UISheetPresentationController, gratuit et correct
Barre d'ongletsNativeTabs (de expo-router/unstable-native-tabs) — la véritable barre d'onglets de la plateforme, ses comportements et transitions inclus
Menu contextuel, aperçu par pression longueLink.Menu / Link.Preview (Expo Router, iOS uniquement) — menus natifs et aperçu, jamais reconstruits en JS
En-tête qui se réduit en un grand titreheaderLargeTitleEnabled sur la pile native (iOS uniquement ; headerLargeTitle est obsolète) — pas un worklet de défilement
Pull to refreshRefreshControl — fait à la main uniquement lorsqu'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, écran videLottie — pour l'illustration uniquement, jamais pour l'état de l'interface
Une scène animée énorme, dessin libre@shopify/react-native-skia — un canevas, pour quand la hiérarchie des vues elle-même est le goulot d'étranglement

Utilisez une valeur partagée uniquement 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 <package> — cela résout la version qui correspond au SDK du projet, ce que npm install simple ne fait pas :

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

4. Choisissez les propriétés

  • transform et opacity sont gratuits. Tout le reste est un passage de disposition. 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é de manière absolue sans enfants — une pilule d'onglet, un remplissage de barre de progression. Il est hors du flux, donc rien d'autre ne se réorganise, 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 la translation en premier sauf si vous voulez la multiplication.
  • Les ombres Android sont elevation, et animer l'élévation réaffiche l'ombre à chaque image. Animez plutôt l'opacité d'un calque pré-ombragé.
  • N'animez jamais l'intensité de BlurView. Sur Android, cela réaffiche le flou à chaque image. Utilisez plutôt un fondu croisé de l'opacité d'un BlurView statique.
  • Les pourcentages fonctionnent dans translate et sont relatifs à la taille de l'élément lui-même — 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 :

InteractionConfiguration
Stabilisation par défaut, pas de dépassement{ duration: 400, dampingRatio: 1 }
Repositionnement / retour après un glissement{ duration: 400, dampingRatio: 0.8, velocity }
Feuille, tiroir{ duration: 300, dampingRatio: 0.8, velocity }
Ne doit pas dépasser une limite stricteajoutez overshootClamping: true

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

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

SituationEasing
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'interface utilisateur. Il commence lentement, retardant le moment exact que l'utilisateur observe. Les intégrés de Reanimated sont aussi faibles que ceux de CSS — utilisez ceux-ci :

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

const EASE_OUT = Easing.bezier(0.23, 1, 0.32, 1);      // ease-out fort pour l'interface utilisateur
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, puce, petit changement d'état150–200ms
Feuille, modale, tiroirressort, ~300ms perçue
Transition d'écranla valeur par défaut de la plateforme — ne la remplacez pas

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

6. Gardez-le hors 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 des saccades dans les applications RN. Valeur partagée → useAnimatedStyle, et React ne se réaffiche jamais du tout.
  • Ne programmez jamais un 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 de Reanimated 4 pour le runOnJS(fn)(...args) obsolète — met en file d'attente un appel du runtime RN, et dans onUpdate, c'est 60–120 fois par seconde. Il appartient à onEnd, ou dans un useAnimatedReaction qui se déclenche lorsqu'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 en plein milieu de la réconciliation, et un réaffichage que vous n'avez pas provoqué rejoue l'écriture. Touchez les valeurs partagées uniquement dans les worklets, les gestionnaires et les effets.
  • Utilisez .get() / .set(), pas .value. Même API, mais l'accès direct à .value est la forme que le compilateur React ne peut pas voir — la documentation de Reanimated appelle get/set la méthode sécurisée 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 tout en fonctionnant correctement dans le débogueur.

7. Pression, pas survol

Chaque affordance de survol du web doit être repensée, pas portée.

  • Retour lors de l'enfoncement, validation lors du 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 avec lui l'étiquette et les icônes, ce qui le rend physique.
  • Cible tactile minimale de 44×44pt (48dp Android). Si le visuel est plus petit, ajoutez hitSlop — ne développez 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 de 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. Vibrations

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

MomentAppel
Une valeur dépasse un pas — sélecteur, détente de curseur, contrôle segmentéHaptics.selectionAsync()
Quelque chose s'enclenche, une détente 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. Une vibration qui retarde son animation se lit comme un défaut, pas comme un retour. Déclenchez-la au moment causal — l'accrochage de la détente — pas lorsque l'animation se termine.
  • Une 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 retour. Les vibrations sont désactivées à l'échelle du système pour de nombreux utilisateurs, et silencieuses sur la plupart du matériel Android. Le visuel doit tenir seul.

À partir d'un worklet, les vibrations doivent être programmées pour revenir au 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 fausse à 200%. N'animez jamais 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 éléments lorsque « l'animation ne s'exécute 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 le plugin Babel des worklets automatiquement — pas d'étape babel.config.js. Seul un projet RN nu sans ce preset ajoute le plugin manuellement, un

…

[truncé pour la traduction]

Individual skills in this repo

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

CharbelElBateh/personal-website

Build an animation from scratch, making the decisions in the order that determines whether it feels right — should it animate at all, what purpose, which tool, which properties, which curve and duration, how it interrupts, how it exits. Writes the implementation. Use when asked to animate something, add motion, make a component feel alive, or build a transition. For critiquing existing motion use review-animations; for auditing a whole codebase use improve-animations.

CharbelElBateh/personal-website

Reverse-lookup glossary that turns a vague description of a web animation or motion effect into its exact term ("the bouncy thing when a popover opens" → Pop in; "the iOS rubber-band scroll" → Rubber-banding). Use when the user asks "what's it called when…", or describes a motion effect without knowing its name and wants the right word to prompt an AI or designer with. For naming an effect, not designing or building one.

CharbelElBateh/personal-website

Apple's approach to interface design and fluid, physical motion, translated for the web. Use when building or reviewing gesture-driven UI, spring animations, drag/swipe/sheet interactions, momentum and interruptible transitions, translucent materials and depth, typography (optical sizing, tracking, leading), reduced-motion, or the design foundations (feedback, spatial consistency, restraint) behind Apple-style interfaces.

CharbelElBateh/personal-website

Guide to Sonner, the React toast library — install and wire up the Toaster, pick the right toast() call, promise and loading toasts, updating, dismissing and persisting toasts, styling, theming and icons, positioning and multiple toasters. Use when working with Sonner or troubleshooting it — toasts that don't appear, appear twice, lose their styles, ignore Tailwind classes, sit behind a modal, or don't follow dark mode.

CharbelElBateh/personal-website

Try to break a piece of UI by feeding it worst-case data — long names, unbreakable emails, one-letter names, missing fields, huge counts, zero items, long labels, non-Latin text, emoji, extreme numbers — then render it behind a "Demo data / Worst case" toggle and report everything that broke, with the fix for each. Use when the user asks to stress-test, break, or find edge cases in a component or screen, or to "try the worst case". For visual design critique use emil-design-eng; for motion use review-animations.

CharbelElBateh/personal-website

This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.

CharbelElBateh/personal-website

Search a codebase or UI for places that don't animate but should, and reject everything that shouldn't. Read-only; it proposes motion with exact values, it does not implement it. Use when the user asks "what could be animated here?" or wants to "make this feel more alive". For fixing existing animations, use improve-animations or review-animations instead.

CharbelElBateh/personal-website

Survey a codebase's animation and motion code as a senior motion advisor, then produce a prioritized audit and self-contained implementation plans for other agents (or cheaper models) to execute. Read-only on source code — it plans improvements, it does not apply them. Use when the user asks to "improve the animations", "audit the motion", "make this app feel better", or wants a roadmap of animation fixes rather than a review of a single diff.

CharbelElBateh/personal-website

Make a web app feel native on a phone — the small CSS and meta-tag fixes that separate "a website in a browser" from something that feels installed. Covers sticky hover states, tap highlight flashes, the 100vh bug, inputs that zoom the page, laggy taps, pull-to-refresh hijacking scroll, content under the notch, long-press selecting button text, carousels that scroll the wrong way, mismatched status bars, and the rule that you test on real hardware. Use when a web app is being built for or reviewed on mobile, when something "works in Chrome but feels wrong on my phone", when building a PWA, a bottom sheet, a carousel, a full-screen layout, or any touch interaction. For motion itself use animate; for React Native use animate-expo.

CharbelElBateh/personal-website

Pick the right library for a given frontend task from a curated, opinionated list — numbers, OTP inputs, charts, command menus, virtualization, drag and drop, toasts, state, styling, and more. Only runs when explicitly invoked; it does not trigger on its own.

CharbelElBateh/personal-website

Build multiple genuinely different versions of a UI piece you describe, rendered behind a visual picker so you can flip through them live and promote the one that feels right. Only runs when explicitly invoked; it does not trigger on its own.

CharbelElBateh/personal-website

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

CharbelElBateh/personal-website

How to write modern Swift well — modeling with value types, Swift 6 data-race safety and approachable concurrency (@concurrent, main-actor-by-default, actors, task groups), protocols and generics (some vs any), API design, performance and ARC, Swift Testing, macros, and the modern language features agents don't know about yet. Use when writing, reviewing, or migrating Swift, or when a concurrency error, a hang, a data race, a retain cycle, or a performance problem needs fixing.

Skills associés