Communitygithub.com

Asymmetric-al/core

Construa animações para Expo e React Native usando Reanimated, Gesture Handler, Expo Router e expo-haptics. Use quando o alvo for um app Expo ou React Native. Não use para animações web no Core Next.js; use `animate` para web. Só é ativado quando invocado explicitamente; não dispara sozinho.

O que é core?

Esta skill é um guia especializado para construir animações de alto desempenho em aplicativos Expo e React Native, utilizando as bibliotecas oficiais da comunidade: Reanimated, Gesture Handler, Expo Router, expo-haptics e outras. Ela foi projetada para ser usada exclusivamente quando o alvo da implementação for um aplicativo mobile nativo (Expo ou React Native), e não para aplicações web do Core Next.js, que possuem suas próprias skills (`animate`, `anim`). O resumo técnico explica que a skill força uma postura operacional de engenheiro sênior: o desenvolvedor deve tomar a decisão de animar ou não, justificar em uma linha e implementar, sem apresentar opções como um menu. A skill aborda três diferenças fundamentais do mobile: ausência de hover, dois runtimes (React Native e UI thread via worklets) e o toque do usuário como entrada primária. Ela fornece regras rígidas, uma sequência de construção em 6 etapas (decidir se anima, nomear o propósito, escolher a ferramenta mais barata que funciona, selecionar propriedades, definir timing/spring e manter a animação fora da thread JS), além de tabelas de configuração de curvas, durações e dependências. A skill também inclui um overlay específico para o repositório Asymmetric-al/core, com gatilhos, workflow e checklist para garantir que animações sejam aplicadas apenas em contextos nativos.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Asymmetric-al/core/tree/HEAD/.agents/skills/animate-expo

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Construindo Animações no Expo

Este repositório (Asymmetric-al/core)

Esta skill é exclusiva para motion em React Native / Expo. Os apps Next.js do Core devem usar animate, emil-design-engineering e anim. Reconcilie este overlay após atualizações upstream antes de executar bun run skills:sync.

Gatilhos

  • Trabalho explícito com animação, gestos, sheets ou haptics no Expo ou React Native.
  • Não carregue para apps web do Core (apps/admin, apps/donor, apps/missionary) ou para motion web do pacote compartilhado packages/ui.

Fluxo de Trabalho

  1. Confirme que a solicitação é nativa/Expo antes de aplicar receitas do Reanimated.
  2. Para superfícies Core Next.js, pare e carregue animate e anim.

Checklist

  • O alvo é Expo/React Native, não apps do App Router do Core.
  • Motion web ainda segue os tokens do Core e a Base UI.

Uma skill de construção para React Native. Ela transforma uma solicitação de movimento em uma implementação que sobrevive a uma revisão rigorosa em um dispositivo real — não no simulador, não em um smartphone topo de linha em modo de desenvolvimento.

O mobile muda três coisas sobre animação, e tudo nesta skill segue delas:

  1. Não existe hover. Cada affordance que a web coloca no hover precisa viver no pressionar, na posição ou no nada.
  2. Existem dois runtimes. Worklets (Reanimated 4) tornam isso explícito: o runtime do React Native, onde o React renderiza e sua lógica de app executa, e o runtime da UI, onde os worklets executam a cada frame (mais runtimes de worker opcionais para trabalho em segundo plano). Uma animação que toca o runtime do RN trava no momento em que o app faz qualquer outra coisa. Toda a arte é manter o motion no runtime da UI.
  3. O dedo do usuário está sobre o elemento. Gestos são a entrada primária, portanto interrompibilidade e passagem de velocidade não são polish — são o padrão.

Postura Operacional

Você é um engenheiro mobile sênior construindo a animação você mesmo. Tome a decisão, declare o raciocínio em uma linha, escreva o código. Nunca apresente opções de movimento como um menu.

Dois modos de falha, e o primeiro é pior:

  1. Animar algo que não deveria ser animado. O portão abaixo existe para produzir zero linhas de código às vezes.
  2. Animar a coisa certa na thread errada — um setState por frame, um PanResponder, uma height animada. Parece bom no desenvolvimento no seu telefone e cai para 20fps em um Android de três anos.

Regras Rígidas

  1. Execute a sequência em ordem. As etapas 1 e 2 controlam tudo.
  2. Reanimated, não o Animated nativo. O Animated nativo não pode ser impulsionado por um gesto sem cruzar a ponte, e useNativeDriver recusa tudo exceto transform e opacity. Worklets do Reanimated executam na thread da UI e continuam executando enquanto o JS está ocupado.
  3. Sem valores aproximados. Curvas e configurações de spring vêm das tabelas abaixo.
  4. Reduced motion é enviado junto com a animação, não como um follow-up.
  5. A sensação é julgada em uma build de release no dispositivo mais lento que você suporta. Nada mais conta como verificado.

A Sequência de Construção

1. Isso deve animar?

FrequênciaDecisão
100+ vezes/dia — troca de abas, abrir/fechar teclado, rolagem, toggles em configuraçõesSem animação. Padrão da plataforma ou nada. Pare aqui.
Dezenas de vezes/dia — feedback de press, navegação em listas, seleção de linhasQuase imperceptível apenas: abaixo de 150ms, ou nada
Ocasional — sheets, modais, toasts, etapas de onboardingAnimação padrão
Raro / primeira vez — estados de sucesso, ilustrações de estado vazio, celebraçãoO orçamento de delight vive aqui

Trocas de aba nunca deslizam. Abas são pares, não uma hierarquia — deslizar implica profundidade que não existe, e o usuário paga por isso dezenas de vezes por sessão. animation: 'none'.

Se a solicitação falhar neste portão, diga isso e não escreva.

2. Qual é o propósito?

Nomeie em uma palavra antes de continuar: feedback, consistência espacial, indicação de estado, prevenir uma mudança brusca, explicação ou delight (apenas camada rara).

Não consegue nomear? Não construa.

3. Escolha a ferramenta — a mais barata que funciona

Desça; pare na primeira que se encaixar.

NecessidadeFerramenta
Uma mudança controlada por estado sem gesto — press, toggle, cor, valor alternandoTransição CSS do Reanimated (transitionProperty no estilo)
Loop, multi-estágio, ou executa na montagem sem mudança de estadoAnimação CSS do Reanimated (animationName keyframes)
Um elemento montando ou desmontando, ou uma lista reorganizandoAnimações de layout (entering / exiting / itemLayoutAnimation)
Qualquer coisa que um dedo toque, ou qualquer coisa derivada de rolagemuseSharedValue + Gesture + useAnimatedStyle
Tela para telaOpções nativas de stack no Expo Router. Nunca faça manualmente
Uma bottom sheet que é sua própria telapresentation: 'formSheet' — é um UISheetPresentationController real, gratuito e correto
Barra de abasNativeTabs (de expo-router/unstable-native-tabs) — a barra de abas real da plataforma, seus comportamentos e transições inclusos
Menu de contexto, preview pressionar e segurarLink.Menu / Link.Preview (Expo Router, apenas iOS) — menus e peek nativos, nunca reconstruídos em JS
Cabeçalho que recolhe em um título grandeheaderLargeTitleEnabled no stack nativo (apenas iOS; headerLargeTitle está obsoleto) — não um scroll worklet
Puxar para atualizarRefreshControl — faça manualmente apenas quando for uma interação característica (veja a receita de limite)
UI que acompanha o tecladoreact-native-keyboard-controller — a posição real do teclado, frame a frame, na thread da UI
Ilustração vetorial, celebração, estado vazioLottie — apenas para ilustração, nunca para estado de UI
Uma cena animada enorme, desenho livre@shopify/react-native-skia — um canvas, para quando a hierarquia de views em si é o gargalo

Recorra a um shared value apenas quando o valor for contínuo ou interrompível. Uma escala de press é uma transição CSS; um arrasto é um shared value. Usar um worklet para um toggle de dois estados é o equivalente mobile de instalar uma biblioteca de motion para um fade.

Dependências. Instale com npx expo install <package> — ele resolve a versão que corresponde ao SDK do projeto, que npm install simples não resolve:

NecessidadePacote
Animaçãoreact-native-reanimated + react-native-worklets
Gestosreact-native-gesture-handler
Navegação, sheets, abas nativas, menusexpo-router
Hapticsexpo-haptics
UI que acompanha o tecladoreact-native-keyboard-controller (precisa de KeyboardProvider na raiz — veja a receita de teclado)
Ilustração, celebraçãolottie-react-native
Cenas animadas muito grandes, desenho personalizado@shopify/react-native-skia

4. Escolha as propriedades

  • transform e opacity são gratuitos. Todo o resto é uma passagem de layout. width, height, margin, padding, flex, top, left, gap reexecutam Yoga em cada frame para aquele nó e seus irmãos.
  • A única exceção: um elemento posicionado absolutamente sem filhos — uma pílula de aba, um preenchimento de barra de progresso. Ele está fora do fluxo, então nada mais se reorganiza, e animar width mantém o raio de borda que scaleX distorceria.
  • Nunca scale(0). Comece de scale(0.9–0.97) + opacity: 0. Nada no mundo real aparece do nada.
  • transform é um array e a ordem importa — [{ translateY }, { scale }] escala após mover; invertido, o translate também é escalado. Mantenha translate primeiro, a menos que queira a multiplicação.
  • Sombras no Android são elevation, e animar elevation re-renderiza a sombra a cada frame. Anime a opacidade de uma camada previamente sombreada.
  • Nunca anime a intensidade do BlurView. No Android ele re-renderiza o desfoque a cada frame. Faça crossfade da opacidade de um BlurView estático.
  • Porcentagens funcionam em translate e são relativas ao tamanho do próprio elemento — translateY('100%') move uma sheet pela sua própria altura independentemente do conteúdo.

5. Timing ou spring

Se um dedo esteve envolvido, use spring. Springs carregam velocidade através de uma interrupção; curvas de timing reiniciam. Todo o resto usa timing.

O spring do Reanimated aceita os dois parâmetros de design da Apple diretamente — use esta forma, não massa/rigidez/amortecimento:

InteraçãoConfig
Ajuste padrão, sem overshoot{ duration: 400, dampingRatio: 1 }
Reposicionar / snap back após um arrasto{ duration: 400, dampingRatio: 0.8, velocity }
Sheet, drawer{ duration: 300, dampingRatio: 0.8, velocity }
Não deve ultrapassar uma borda rígidaadicione overshootClamping: true

Bounce apenas quando o gesto carregou momentum. Overshoot em um menu que apareceu gradualmente parece errado; overshoot em um cartão que você lançou parece certo.

Easing, para tudo sem um dedo:

SituaçãoEasing
Entrando ou saindoease-out
Movendo / morfando na telaease-in-out
Movimento constante (progresso, marquee)linear
Padrãoease-out

Nunca ease-in na UI. Ele começa devagar, atrasando o exato momento que o usuário está observando. Os built-ins do Reanimated são tão fracos quanto os do CSS — use estes:

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

const EASE_OUT = Easing.bezier(0.23, 1, 0.32, 1); // ease-out forte para UI
const EASE_IN_OUT = Easing.bezier(0.77, 0, 0.175, 1); // movimento na tela
const EASE_SHEET = Easing.bezier(0.32, 0.72, 0, 1); // curva de sheet do iOS

Duração:

ElementoDuração
Feedback de press100–150ms
Toggle, chip, pequena mudança de estado150–200ms
Sheet, modal, drawerspring, ~300ms percebido
Transição de telao padrão da plataforma — não sobrescreva

Animações de UI mobile ficam abaixo de 300ms, assim como na web. As transições da própria plataforma são mais longas (push do iOS é 350ms); corresponda à plataforma para navegação, supere em todo o resto.

6. Mantenha fora da thread JS

Esta é a arte específica do mobile, e é onde a maioria dos movimentos em React Native morre.

  • Nunca setState a partir de um manipulador de gesto ou rolagem. Uma renderização React por frame é a maior causa de jank em apps RN. Shared value → useAnimatedStyle, e React nunca re-renderiza.
  • Nunca agende de volta para o runtime do RN dentro de onUpdate ou de um manipulador de rolagem. scheduleOnRN(fn, ...args) de react-native-worklets — o substituto para o obsoleto runOnJS(fn)(...args) no Reanimated 4 — enfileira uma chamada no runtime do RN, e em onUpdate isso é 60–120× por segundo. Pertence a onEnd, ou a um useAnimatedReaction que dispara quando um valor cruza um limiar.
  • Nunca leia um shared value durante a renderização (translateY.get() em JSX). É um snapshot que nunca atualiza e silenciosamente quebra toda a animação. Acesse shared values dentro de worklets ou useAnimatedStyle.

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.

Habilidades Relacionadas