Communitygithub.com

Construcción de Animaciones en Expo

Construye animaciones en React Native y Expo, tomando decisiones en el orden que determinan si se sienten correctas: qué debe animarse, en qué hilo se ejecuta, qué propiedades animar, spring o timing, cómo se entrega el gesto, cómo se degrada. Escribe la implementación con Reanimated, Gesture Handler, Expo Router y expo-haptics. Úsalo al animar cualquier cosa en una app Expo, agregar gestos, hojas, transiciones de pantalla, feedback táctil o hápticos, o al corregir movimientos que tartamudean en el dispositivo. Para animación web usa `animate`.

¿Qué es Construcción de Animaciones en Expo?

Esta habilidad te guía a través del proceso completo de construcción de animaciones en React Native y Expo, siguiendo la filosofía de animación de Emil Kowalski. Se enfoca en garantizar que las animaciones se sientan correctas en un dispositivo real, no en el simulador ni en un teléfono insignia en modo de desarrollo. La habilidad establece reglas estrictas: usar Reanimated en lugar del `Animated` básico, ejecutar la secuencia de construcción en orden (decidir si debe animarse, cuál es su propósito, elegir la herramienta más barata que funcione, seleccionar propiedades, elegir entre timing o spring, mantener la animación fuera del hilo JS, y manejar la reducción de movimiento y accesibilidad). También cubre el uso de hápticos, la adaptación de interacciones de hover a press en dispositivos móviles, y las dependencias necesarias como `react-native-reanimated`, `react-native-gesture-handler`, `expo-router` y `expo-haptics`. La habilidad es ideal para desarrolladores que buscan animaciones de alto rendimiento y con una sensación nativa, y advierte contra errores comunes como animar en el hilo incorrecto o usar valores aproximados.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CharbelElBateh/personal-website/tree/HEAD/.claude/skills/animate-expo

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Construcción de Animaciones en Expo?

Respuesta Inicial

Cuando esta habilidad se invoca por primera vez sin una pregunta específica, responde solo con:

Estoy listo para construir animaciones en Expo y React Native que se sientan correctas en un dispositivo real, mi conocimiento proviene de la filosofía de animación de Emil Kowalski.

No proporciones ninguna otra información hasta que el usuario haga una pregunta.

Una habilidad de construcción para React Native. Convierte una solicitud de movimiento en una implementación que supera una revisión estricta en un dispositivo real, no en el simulador, ni en un teléfono insignia en modo de desarrollo.

Lo móvil cambia tres cosas sobre la animación, y todo en esta habilidad se deriva de ellas:

  1. No hay hover. Cada ventaja que la web pone en el hover tiene que vivir en press, posición o nada.
  2. Hay dos runtimes. Worklets (Reanimated 4) lo hace explícito: el runtime de React Native, donde React renderiza y tu lógica de aplicación se ejecuta, y el runtime de UI, donde los worklets se ejecutan en cada frame (más runtimes de worker opcionales para trabajo en segundo plano). Una animación que toca el runtime de RN tartamudea en el momento en que la aplicación hace cualquier otra cosa. Todo el arte está en mantener el movimiento en el runtime de UI.
  3. El dedo del usuario está sobre el elemento. Los gestos son la entrada principal, por lo que la capacidad de interrupción y la transferencia de velocidad no son un lujo, son la línea de base.

Postura Operativa

Eres un ingeniero móvil senior que construye la animación tú mismo. Toma la decisión, expón el razonamiento en una línea, escribe el código. Nunca presentes opciones de movimiento como un menú.

Dos modos de fallo, y el primero es peor:

  1. Animar algo que no debería animarse. La puerta de abajo existe para producir cero líneas de código a veces.
  2. Animar lo correcto en el hilo incorrecto — un setState por frame, un PanResponder, un height animado. Se ve bien en desarrollo en tu teléfono y baja a 20fps en un Android de tres años.

Reglas Estrictas

  1. Ejecuta la secuencia en orden. Los pasos 1 y 2 son la puerta de todo.
  2. Reanimated, no el Animated básico. El Animated básico no puede ser manejado por un gesto sin cruzar el puente, y useNativeDriver rechaza cualquier cosa que no sea transform y opacity de todos modos. Los worklets de Reanimated se ejecutan en el hilo de UI y siguen ejecutándose mientras JS está ocupado.
  3. Sin valores aproximados. Las curvas y configuraciones de spring provienen de las tablas a continuación.
  4. El movimiento reducido se envía con la animación, no como un seguimiento.
  5. La sensación se juzga en una compilación de lanzamiento en el dispositivo más lento que soportas. Nada más cuenta como verificado.

La Secuencia de Construcción

1. ¿Debería esto animarse en absoluto?

FrecuenciaDecisión
100+ veces/día — cambios de pestaña, abrir/cerrar teclado, desplazamiento, alternar en configuracionesSin animación. Valor predeterminado de la plataforma o nada. Detente aquí.
Decenas de veces/día — feedback táctil, navegación de lista, selección de filaSolo casi imperceptible: menos de 150ms, o nada
Ocasional — hojas, modales, toasts, pasos de incorporaciónAnimación estándar
Raro / primera vez — estados de éxito, ilustraciones de estado vacío, celebracionesEl presupuesto de deleite vive aquí

Los cambios de pestaña nunca se deslizan. Las pestañas son pares, no una jerarquía — deslizar implica profundidad que no está ahí, y el usuario paga por ello docenas de veces por sesión. animation: 'none'.

Si la solicitud falla esta puerta, dilo y no la escribas.

2. ¿Cuál es el propósito?

Nómbralo en una palabra antes de continuar: feedback, consistencia espacial, indicación de estado, prevenir un cambio brusco, explicación, o deleite (solo nivel raro).

¿No puedes nombrarlo? No lo construyas.

3. Elige la herramienta — la más barata que funcione

Camina hacia abajo; detente en la primera que encaje.

NecesidadHerramienta
Un cambio controlado por estado sin gesto — press, alternar, color, un valor que cambiaTransición CSS de Reanimated (transitionProperty en el estilo)
Bucle, multi-etapa, o se reproduce al montar sin cambio de estadoAnimación CSS de Reanimated (animationName keyframes)
Un elemento montando o desmontando, o una lista reordenándoseAnimaciones de layout (entering / exiting / itemLayoutAnimation)
Cualquier cosa que un dedo toque, o cualquier cosa derivada del desplazamientouseSharedValue + Gesture + useAnimatedStyle
De pantalla a pantallaOpciones de stack nativas en Expo Router. Nunca hagas esto manualmente
Una hoja inferior que es su propia pantallapresentation: 'formSheet' — es un UISheetPresentationController real, gratuito y correcto
Barra de pestañasNativeTabs (de expo-router/unstable-native-tabs) — la barra de pestañas real de la plataforma, sus comportamientos y transiciones incluidas
Menú contextual, vista previa de presionar y mantenerLink.Menu / Link.Preview (Expo Router, solo iOS) — menús nativos y vistas previas, nunca reconstruidos en JS
Encabezado que se colapsa en un título grandeheaderLargeTitleEnabled en el stack nativo (solo iOS; headerLargeTitle está obsoleto) — no un worklet de desplazamiento
Tirar para actualizarRefreshControl — solo manual cuando es una interacción característica (ver la receta de umbral)
UI que sigue al tecladoreact-native-keyboard-controller — la posición real del teclado, frame por frame, en el hilo de UI
Ilustración vectorial, celebración, estado vacíoLottie — solo para ilustración, nunca para estado de UI
Una escena animada enorme, dibujo libre@shopify/react-native-skia — un canvas, para cuando la jerarquía de vistas en sí es el cuello de botella

Usa un valor compartido solo cuando el valor es continuo o interrumpible. Una escala de press es una transición CSS; un arrastre es un valor compartido. Usar un worklet para un alternador de dos estados es el equivalente móvil de instalar una librería de movimiento para un desvanecimiento.

Dependencias. Instala con npx expo install <paquete> — resuelve la versión que coincide con el SDK del proyecto, lo que npm install simple no hará:

NecesidadPaquete
Animaciónreact-native-reanimated + react-native-worklets
Gestosreact-native-gesture-handler
Navegación, hojas, pestañas nativas, menúsexpo-router
Hápticosexpo-haptics
UI que sigue al tecladoreact-native-keyboard-controller (necesita KeyboardProvider en la raíz — ver la receta de teclado)
Ilustración, celebraciónlottie-react-native
Escenas animadas muy grandes, dibujo personalizado@shopify/react-native-skia

4. Elige las propiedades

  • transform y opacity son gratuitos. Todo lo demás es un pase de layout. width, height, margin, padding, flex, top, left, gap vuelven a ejecutar Yoga en cada frame para ese nodo y sus hermanos.
  • La única excepción: un elemento posicionado absolutamente sin hijos — una píldora de pestaña, un relleno de barra de progreso. Está fuera del flujo, por lo que nada más se re-layout, y animar width mantiene el radio de esquina que scaleX distorsionaría.
  • Nunca scale(0). Comienza desde scale(0.9–0.97) + opacity: 0. Nada en el mundo real aparece de la nada.
  • transform es un array y el orden importa — [{ translateY }, { scale }] escala después de mover; invertido, la traducción también se escala. Mantén translate primero a menos que quieras la multiplicación.
  • Las sombras en Android son elevation, y animar elevation re-renderiza la sombra cada frame. Anima la opacidad de una capa pre-sombreada en su lugar.
  • Nunca animes la intensidad de BlurView. En Android re-renderiza el desenfoque cada frame. En su lugar, haz un crossfade de la opacidad de un BlurView estático.
  • Los porcentajes funcionan en translate y son relativos al tamaño propio del elemento — translateY('100%') mueve una hoja por su propia altura independientemente de su contenido.

5. Timing o spring

Si un dedo estuvo involucrado, usa un spring. Los springs llevan la velocidad a través de una interrupción; las curvas de timing se reinician. Todo lo demás usa timing.

El spring de Reanimated toma los dos parámetros de diseño de Apple directamente — usa esta forma, no mass/stiffness/damping:

InteracciónConfiguración
Asentamiento predeterminado, sin sobreimpulso{ duration: 400, dampingRatio: 1 }
Reposicionamiento / retroceso después de un arrastre{ duration: 400, dampingRatio: 0.8, velocity }
Hoja, cajón{ duration: 300, dampingRatio: 0.8, velocity }
No debe pasar un borde duroañadir overshootClamping: true

Rebota solo cuando el gesto llevó impulso. El sobreimpulso en un menú que se desvanece se siente mal; el sobreimpulso en una tarjeta que lanzaste se siente bien.

Easing, para todo sin un dedo sobre él:

SituaciónEasing
Entrando o saliendoease-out
Moviéndose / transformándose en pantallaease-in-out
Movimiento constante (progreso, marquee)linear
Predeterminadoease-out

Nunca ease-in en UI. Comienza lento, retrasando el momento exacto que el usuario está observando. Los built-ins de Reanimated son tan débiles como los de CSS — usa estos:

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

const EASE_OUT = Easing.bezier(0.23, 1, 0.32, 1);      // ease-out fuerte para UI
const EASE_IN_OUT = Easing.bezier(0.77, 0, 0.175, 1);  // movimiento en pantalla
const EASE_SHEET = Easing.bezier(0.32, 0.72, 0, 1);    // curva de hoja iOS

Duración:

ElementoDuración
Feedback táctil100–150ms
Alternador, chip, pequeño cambio de estado150–200ms
Hoja, modal, cajónspring, ~300ms percibido
Transición de pantallael valor predeterminado de la plataforma — no lo anules

Las animaciones de UI móvil se mantienen por debajo de 300ms, igual que en la web. Las transiciones de la propia plataforma son más largas (el push de iOS es 350ms); iguala la plataforma para la navegación, superala en todos los demás lugares.

6. Mantenlo fuera del hilo JS

Este es el arte específico móvil, y es donde muere la mayor parte del movimiento en React Native.

  • Nunca setState desde un gesto o un manejador de desplazamiento. Un render de React por frame es la causa única más grande de tartamudeo en apps RN. Valor compartido → useAnimatedStyle, y React nunca re-renderiza en absoluto.
  • Nunca programes un retorno al runtime de RN dentro de onUpdate o un manejador de desplazamiento. scheduleOnRN(fn, ...args) de react-native-worklets — el reemplazo de Reanimated 4 para el obsoleto runOnJS(fn)(...args) — pone en cola una llamada al runtime de RN, y en onUpdate eso es 60–120 veces por segundo. Pertenece en onEnd, o en un useAnimatedReaction que se dispara cuando un valor cruza un umbral.
  • Nunca leas un valor compartido durante el render (translateY.get() en JSX). Es una instantánea que nunca se actualiza y se desincroniza silenciosamente. Nunca escribas uno durante el render tampoco — se dispara en medio de la reconciliación, y un re-render que no causaste reproduce la escritura. Toca los valores compartidos solo en worklets, handlers y efectos.
  • Usa .get() / .set(), no .value. Misma API, pero el acceso directo a .value es la forma que el Compilador de React no puede ver — la documentación de Reanimated llama a get/set la forma segura para el compilador. set también toma una actualización funcional: sv.set((v) => v + 1).
  • Las funciones llamadas desde un worklet necesitan 'worklet' como su primera línea, o lanzarán un error en tiempo de ejecución en el dispositivo mientras funcionan bien en el depurador.

7. Press, no hover

Cada ventaja de hover de la web tiene que ser rediseñada, no portada.

  • Feedback al presionar, confirma al soltar. Esperar a que el toque se complete antes de mostrar cualquier cosa se siente muerto — esta es la latencia que el usuario realmente percibe.
  • scale: 0.97 en 100–150ms en cualquier elemento presionable, Pressable + una transición CSS. scale lleva la etiqueta y los iconos consigo, que es lo que lo hace sentir físico.
  • Objetivo táctil mínimo de 44×44pt (48dp Android). Si lo visual es más pequeño, añade hitSlop — no agrandes lo visual.
  • pressRetentionOffset para que un dedo que se desvía unos píxeles no cancele un press que el usuario pretendía.
  • Onda Android solo en una app con estilo Material. En una app con diseño personalizado, la misma escala en ambas plataformas es más coherente que una onda en una.

8. Hápticos

Lo móvil tiene un sentido que la web no tiene. Úsalo con moderación y se convierte en lo que hace que la app se sienta cara; úsalo en todas partes y los usuarios lo desactivan.

MomentoLlamada
Un valor pasa un paso — selector, detente de slider, control segmentadoHaptics.selectionAsync()
Algo encaja en su lugar, un detente de hoja atrapa, un arrastre se confirmaHaptics.impactAsync(ImpactFeedbackStyle.Light)
Un objeto pesado aterriza, una acción destructiva se activaHaptics.impactAsync(ImpactFeedbackStyle.Medium)
Operación exitosa o fallidaHaptics.notificationAsync(NotificationFeedbackType.Success / Error)

Tres reglas, y son absolutas:

  • Mismo frame que lo visual. Un háptico que se retrasa respecto a su animación se lee como un fallo, no como feedback. Dispáralo en el momento causal — el detente atrapando — no cuando la animación termina.
  • Uno por acción del usuario. Nunca en desplazamiento, nunca por frame, nunca en una animación de entrada que el usuario no causó.
  • Nunca el único feedback. Los hápticos están desactivados a nivel de sistema para muchos usuarios, y son silenciosos en la mayoría del hardware Android. Lo visual tiene que mantenerse por sí solo.

Desde un worklet, los hápticos deben ser programados de vuelta al runtime de RN: scheduleOnRN(Haptics.selectionAsync).

9. Movimiento reducido y accesibilidad

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

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

// o deja que cada animación decida
withSpring(0, { duration: 300, dampingRatio: 0.8, reduceMotion: ReduceMotion.System });

Movimiento reducido significa menos y más suave, no cero: mantén los cambios de opacidad y color que explican un cambio de estado, elimina traslación, escala, paralaje y sobreimpulso. Las transiciones de pantalla se convierten en animation: 'fade'.

Escalado de texto. allowFontScaling está activado por defecto, por lo que cualquier altura que mediste en el tamaño de tipo predeterminado está equivocada al 200%. Nunca animes a una altura fija — mide con onLayout, o anima una transformación en su lugar.

Configuración que rompe el movimiento silenciosamente

Revisa esto primero cuando "la animación simplemente no se ejecuta":

  • Instala a través de Expo para que las versiones coincidan con el SDK: npx expo install react-native-reanimated react-native-worklets. En un proyecto Expo, babel-preset-expo configura el plugin de Babel para worklets automáticamente — no hay paso de babel.config.js. Solo un proyecto RN sin ese preset añade el plugin manualmente, y eso se ha vuelto raro desde Expo SDK 52+.

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 relacionados