Communitygithub.com

Asymmetric-al/core

Créez des animations pour Expo et React Native uniquement, en utilisant Reanimated, Gesture Handler, Expo Router et expo-haptics. Utilisez-le lorsque l'environnement d'exécution cible est une application Expo ou React Native. Ne l'utilisez pas pour le motion web Core Next.js ; utilisez `animate` pour le web. Ne s'exécute que lorsqu'il est explicitement invoqué ; ne se déclenche pas tout seul.

Qu'est-ce que core ?

Ce skill est conçu pour les développeurs mobiles travaillant sur des applications Expo ou React Native. Il fournit un guide structuré et des règles strictes pour créer des animations performantes et fluides, en mettant l'accent sur l'utilisation de `react-native-reanimated` et `react-native-gesture-handler`. Le skill évite les animations inutiles, en particulier pour les actions fréquentes comme les changements d'onglets, et se concentre sur l'exécution des animations sur le thread UI pour éviter les ralentissements. Il couvre la sélection des outils les plus adaptés (transitions CSS, animations, gestes), le choix des propriétés d'animation (transform, opacity), et les configurations de timing et de ressort. Il intègre également des considérations de performance spécifiques aux mobiles, comme l'absence de survol, la gestion des deux runtimes (RN et UI), et l'importance de l'interruptibilité des gestes. Le skill est destiné à être exécuté explicitement pour les tâches d'animation native, et non pour le développement web Core Next.js.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Asymmetric-al/core/tree/HEAD/.agents/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

Ce dépôt (Asymmetric-al/core)

Ce skill est destiné uniquement au motion React Native / Expo. Les applications Next.js de Core doivent utiliser animate, emil-design-engineering et anim à la place. Conciliez cette superposition après les mises à jour en amont avant d'exécuter bun run skills:sync.

Déclencheurs

  • Travail explicite d'animation, de geste, de feuille ou de haptique pour Expo ou React Native.
  • Ne le chargez pas pour les applications web Core (apps/admin, apps/donor, apps/missionary) ou le motion web partagé packages/ui.

Flux de travail

  1. Confirmez que la demande est native/Expo avant d'appliquer les recettes Reanimated.
  2. Pour les surfaces Core Next.js, arrêtez-vous et chargez animate plus anim.

Liste de vérification

  • L'environnement d'exécution cible est Expo/React Native, pas les applications Core App Router.
  • Le motion web suit toujours les tokens Core et Base UI.

Un skill de construction pour React Native. Il transforme une demande de mouvement en une implémentation qui résiste à une revue stricte sur un appareil réel — pas dans le simulateur, pas sur un téléphone phare en mode dev.

Le mobile change trois choses à propos de l'animation, et tout dans ce skill 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 fait le rendu et où votre logique applicative 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 est de maintenir le motion 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 polissage — 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 motion 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 bien en dev sur votre téléphone et tombe à 20fps sur un Android de trois ans.

Règles strictes

  1. Exécutez la séquence dans l'ordre. Les étapes 1 et 2 conditionnent 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 transform et opacity de toute façon. 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 approximatives. Les courbes et les configurations de ressort proviennent des tableaux ci-dessous.
  4. Le motion réduit est livré avec l'animation, pas en tant que 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 être animé du tout ?

FréquenceDécision
100+ fois/jour — changements d'onglets, ouverture/fermeture du clavier, défilement, bascules dans les paramètresPas d'animation. Valeur 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 lignePresque imperceptible seulement : moins 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 de plaisir vit ici

Les onglets 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, plusieurs étapes, ou se joue 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 layout (entering / exiting / itemLayoutAnimation)
Tout ce qu'un doigt touche, ou tout ce qui dérive d'un défilementuseSharedValue + Gesture + useAnimatedStyle
Écran à écranOptions de stack native 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 par appui prolongéLink.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 stack native (iOS uniquement ; headerLargeTitle est déprécié) — pas un worklet de défilement
Pull to refreshRefreshControl — faites-le à la main seulement quand c'est 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 l'illustration seulement, jamais pour l'état UI
Une scène animée immense, dessin libre@shopify/react-native-skia — un canevas, pour 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 motion 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 ne fera pas :

BesoinPackage
Animationreact-native-reanimated + react-native-worklets
Gestesreact-native-gesture-handler
Navigation, feuilles, onglets natifs, menusexpo-router
Haptiquesexpo-haptics
UI suivant 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 réorganise, et animer width conserve le rayon de bordure que scaleX étalerait.
  • Jamais scale(0). Commencez à 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 refait le rendu de l'ombre à chaque image. Animez plutôt l'opacité d'une couche pré-ombragée.
  • N'animez jamais l'intensité de BlurView. Sur Android, cela refait le rendu du flou à chaque image. Croisez plutôt l'opacité d'un BlurView statique.
  • Les pourcentages fonctionnent dans translate et sont relatifs à la taille propre 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 a été 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 directement les deux paramètres de conception d'Apple — utilisez cette forme, pas mass/stiffness/damping :

InteractionConfiguration
Stabilisation par défaut, sans 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 un bord durajoutez overshootClamping: true

Rebond seulement quand le geste a porté 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 lancée semble juste.

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

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

Jamais ease-in sur l'UI. Cela 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); // strong ease-out 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çus
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 à 350ms) ; correspond à la plateforme pour la navigation, battez-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 motions 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 refait jamais le rendu du tout.
  • Ne planifiez jamais un retour vers le runtime RN à l'intérieur de onUpdate ou d'un gestionnaire de défilement. scheduleOnRN(fn, ...args) depuis 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. Il appartient à onEnd, ou dans 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 du JSX). C'est un instantané qui ne se met jamais à jour et il le fait silencieusement...

Individual skills in this repo

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

Asymmetric-al/core

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. Only runs when explicitly invoked; it does not trigger on its own.

Asymmetric-al/core

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.

Asymmetric-al/core

Inspect a Core UI or code surface for a small number of justified motion opportunities and explicitly identify what should remain static. Use when asked what should animate, where motion would improve feedback or comprehension, how to make an interface feel more alive without over-animating it, or whether a proposed animation is worth adding. Read-only; do not use to review or fix existing motion code or to implement animations.

Asymmetric-al/core

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.

Asymmetric-al/core

Implement smooth, accessible animations with motion/react (Framer Motion) in React. Use when adding animations, gestures, or layout transitions with motion, AnimatePresence, useScroll, and related APIs. Requires a 'use client' boundary; not for strictly server-rendered components or when no animation is needed.

Asymmetric-al/core

Best practices for Remotion - Video creation in React

Asymmetric-al/core

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

Skills associés