Communitygithub.com

antheo-motion

Decide se uma coisa deve se mover, depois dá a ela tempo, suavização e distância exatos (pressionamentos, hovers, menus, diálogos, painéis, arrastos, transições de página) com suporte a movimento reduzido. Use quando a UI parecer travada, estática ou exagerada, quando uma gaveta ou arrasto parecer errado, ou antes de publicar qualquer animação.

O que é antheo-motion?

O skill **antheo-motion** é uma biblioteca de princípios e tokens para animação de interface que ajuda você a decidir **se** e **como** algo deve se mover, em vez de apenas fornecer valores pré-definidos. Ele organiza as animações por finalidade (qual mudança está acontecendo?) e frequência (quantas vezes o usuário vê aquilo?), atribuindo durações específicas (100ms a 400ms), curvas de suavização e distâncias de deslocamento. Suporta qualquer plataforma que use CSS (web) e inclui scripts práticos como `filmstrip.mjs` para filmar e verificar cada animação quadro a quadro em condições de câmera lenta, tema claro/escuro e movimento reduzido. É útil em projetos que utilizam agentes de IA como Claude Code ou Cursor para auditar, planejar ou cortar animações, garantindo consistência, acessibilidade (WCAG) e desempenho em toda a aplicação.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/antheo-design/skills/tree/HEAD/skills/antheo-motion

Perguntar na sua IA favorita

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

Documentação

Antheo Motion

Movimento é informação sobre mudança: algo chegou, saiu, moveu-se ou respondeu a você. Movimento que não explica nada é ruído; uma mudança sem movimento é um salto. Este skill decide quais mudanças se movem e dá a cada uma seu tempo exato. O momento de assinatura de um componente pertence ao antheo-moment; os tokens de duração são gerados pelo antheo-tokens; o requisito de movimento reduzido é verificado pelo antheo-access. Auditar, cortar ou planejar o movimento em toda uma aplicação é tarefa do antheo-motion-audit.

Decida nesta ordem

  1. Liste cada mudança que a tela sofre: o que abre, fecha, aparece, some, reordena, atualiza, carrega, tem sucesso ou falha.
  2. Marque com que frequência uma pessoa vê cada uma: muitas vezes ao dia, diariamente ou raramente.
  3. Dê a cada uma sua duração e suavização a partir das tabelas abaixo.
  4. Entregue o evento raro e significativo, se houver, ao antheo-moment.
  5. Verifique rápido, duas vezes e com movimento reduzido, depois filme e leia os quadros (abaixo).

Nomeie por que se move, ou não mova

"Isso se move para que a pessoa entenda ___." Não consegue completar a frase: sem animação.

Quanto mais frequente, menos se move

Com que frequênciaRecebe
Muitas vezes ao dia (digitação, linhas, abas, menus, uma paleta)no máximo 150ms, 4px de deslocamento; pelo teclado, apenas um fade curto
Diariamente (um diálogo, um painel, um toast, um salvamento)uma chegada curta e uma saída mais rápida, 150 a 300ms
Raramente (um primeiro sucesso, um pedido feito)o único lugar para um momento de assinatura (antheo-moment)

As durações, por função

TokenValorLeva
--dur-instant100msfeedback de cor e opacidade
--dur-fast150mspressionamento, hover (entrada e saída), abertura de menu ou tooltip
--dur-base200mssaída de coisas, fechamento de diálogo, troca de valor ou texto, chegada de toast
--dur-open250msabertura de diálogo, abas, acordeão, redimensionamento de cartão
--dur-slow300mspainel ou gaveta subindo, marcador deslizando
--dur-page400mstransição de página ou elemento compartilhado

Animações de interface ficam em ou abaixo de 300ms; movimentos de página em ou abaixo de 400ms. Spinners, progresso e movimento vinculado a rolagem usam linear.

Abertura e fechamento, em pares

CoisaAbreFecha
Menu, popover, select150ms, a partir de scale(0.97) e um fade, no gatilho120ms
Tooltip400ms de atraso, depois um fade de 150ms; imediatamente se dentro de 300ms de outra que fechouImediatamente
Diálogo250ms: subida de 8px, fade, escala a partir de 0.96200ms
Painel, gaveta300ms a partir de sua borda, totalmente opaco durante todo o percurso (sem fade, sem blur)200ms
Toast200ms, subida de 12px200ms, saindo pelo mesmo caminho que veio
Acordeão, revelação de altura250ms, grid-template-rows: 0fr para 1fr200ms

Nunca atrase um fechamento ou um hover-out: encurte a duração.

Uma única curva para chegar e sair

--ease-out cubic-bezier(0.23, 1, 0.32, 1) para tudo que entra ou sai. --ease-in-out cubic-bezier(0.77, 0, 0.175, 1) apenas para algo que se move de um lugar a outro na tela. --ease-in apenas para algo descartado permanentemente. Saídas são mais rápidas que entradas e percorrem cerca de metade da distância.

Pequenas distâncias, nunca partindo de zero

Desloque 4px para troca de valor ou popover, 8px para diálogo, 12px para toast, 24px para um elemento herói; a borda completa apenas para um painel. Entre a partir de scale(0.96) (0.97 para menus, 0.98 para tooltips) com opacidade 0, nunca a partir de scale(0). Blur de 4px em troca de texto ou ícone, 8px em superfície grande, 2px em crossfade abaixo de 200ms.

O que pode animar

transform e opacity (e cor) por padrão; um breve blur de filter, clip-path e grid-template-rows para revelações de altura quando necessário. Nunca transition: all, nunca width, height, top, left ou margin, nunca box-shadow em si: coloque uma sombra variável em um pseudo-elemento e desbote-a. will-change apenas após um perfil pedir.

Cresça a partir do gatilho

Menus e popovers tomam seu transform-origin no gatilho (Radix expõe --radix-popover-content-transform-origin); um modal permanece centralizado; um painel vem da borda em que vive; um elemento compartilhado (um cartão abrindo em sua página) usa um único view-transition-name em cada lado.

Transições para estado, keyframes para eventos únicos

Qualquer coisa que uma pessoa possa alternar usa uma transição CSS ou uma mola, que revertem no meio do caminho; keyframes apenas para coisas que tocam uma vez.

Stagger de 30 a 40ms, os primeiros oito, 300ms no total

60 a 80ms para as três a seis partes de um herói. Nunca use stagger em algo aberto com frequência, e nunca bloqueie um clique enquanto os itens chegam.

Molas apenas onde uma mão as move

Um botão de alternância, um arrasto solto, uma pílula segmentada deslizante. Ressalto de 0 a 0.2 em controles (o overshoot fica dentro da trilha), até 0.45 para uma celebração rara; no máximo uma oscilação. Um arrasto segue o dedo sem transição e, ao soltar, usa mola a partir da velocidade de soltura; um painel fecha com um flick mais rápido que cerca de 0.11px por ms, ou após percorrer min(64px, 15%) de sua altura, caso contrário retorna com mola (references/gestures.md).

Nada pula

Cada valor que muda é visto mudar; uma linha removida fecha seu espaço; o espaço é reservado para o que aparece (deslocamento de layout abaixo de 0.1). Ao carregar, no máximo uma entrada. Alterne temas com transições desligadas por um quadro.

Movimento reduzido mantém a história em fades

Com prefers-reduced-motion: reduce, deslocamento, escala, blur, parallax e saltos tornam-se um crossfade de opacidade de 150 a 200ms; um botão de alternância move-se imediatamente; loops automáticos param. Qualquer coisa que se mova por mais de 5 segundos sozinha tem um controle de pausa (WCAG 2.2.2); nada pisca mais de 3 vezes por segundo (2.3.1).

Em toda a aplicação

  1. Encontre: uma tabela de cada mudança, com que frequência é vista, como se move agora, como deveria.
  2. Melhore: tokens para cada número, as saídas faltantes, origem no gatilho, um padrão de cada vez.
  3. Remova: qualquer coisa que anime a cada carregamento, toque em uma ação de muitas vezes ao dia, atrase a próxima ação, loope enquanto as pessoas leem, ou ultrapasse 300ms em uma ação rotineira. Quando em dúvida, remova.
  4. Aprove ou bloqueie: uma frase de motivo, apenas tokens, apenas as propriedades permitidas, uma saída mais rápida que a entrada, movimento reduzido tratado, assistido em velocidade normal e com desaceleração de CPU 4×.

Verifique

Clique em tudo rápido, duas vezes: reverte, nunca pula. Abra o menu vinte vezes: ainda rápido. Force a CPU 4×: ainda suave. Ative movimento reduzido: nada se desloca.

Assista: uma imagem estática não julga movimento

Uma captura de tela do estado final não diz nada sobre como uma coisa se move, e todo verificador lê quadros estáticos. Então filme cada movimento que fez e olhe os quadros antes de considerar concluído:

node <antheo-motion>/scripts/filmstrip.mjs <url> --clip ".tuner" --click ".preset" --duration 600
node <antheo-motion>/scripts/filmstrip.mjs <url> --clip ".sheet" --drag ".handle" --by 0,240 --duration 900

Isso desacelera a página para 0.1× (CSS, Web Animations e o relógio JavaScript), faz a única ação e dispõe 12 quadros do elemento em uma folha, cada um com seu tempo. Abra a folha e leia cada quadro:

  • cada quadro parece composto por si só: nenhuma borda dura deslizando, nenhum flash de cor errada, nenhuma caixa vazia
  • cada valor que muda é visto mudar: um número que deveria rolar não pula enquanto sua agulha ainda viaja
  • nada reflui ou pula no meio do caminho; o primeiro quadro já responde ao pressionamento
  • o final se estabelece onde deveria: uma mola overshota um pouco e volta, um controle não para de repente
  • filme novamente com --reduce e --dark: a história ainda é contada, e o escuro não tem flash de luz

Corrija o que um quadro mostra, filme novamente e mantenha a última folha como evidência.

O que a UI gerada erra aqui

Verifique cada item em references/habits.md antes de considerar concluído: transition: all · conteúdo oculto até um script revelá-lo · um reset genérico de movimento reduzido · um anel de foco que desbota ou desliza · movimento que performa · efeitos hover em coisas que não são clicáveis · uma transição lendo um nome que ninguém definiu.

Quando mais movimento é correto

As regras de propósito e frequência decidem; os números são padrões. Um jogo, uma ferramenta criativa, um produto de aprendizado ou um momento de marca que a pessoa pediu podem se mover mais e por mais tempo. Ainda assim responde à entrada imediatamente, nunca bloqueia a próxima ação, pode ser interrompido no meio do caminho, respeita movimento reduzido e mostra seu custo: um quadro lento em um telefone de gama média é uma descoberta, independentemente do estilo.

Concluído

  • Cada mudança listada com sua frequência de visualização; as frequentes mal se movem; ações de teclado não viajam
  • Durações e suavização a partir dos tokens; os pares de abertura e fechamento acima; sem fechamentos atrasados
  • Apenas as propriedades permitidas; origem no gatilho; nada a partir de scale(0)
  • Movimento reduzido torna-se um crossfade; loops acima de 5s podem pausar
  • Clicado rápido duas vezes, com desaceleração 4× e com movimento reduzido
  • Cada movimento filmado (scripts/filmstrip.mjs), cada quadro lido, claro, escuro e reduzido
  • Verificado contra cada hábito em references/habits.md

Arquivos

  • scripts/filmstrip.mjs: filma um movimento a 0.1× em uma folha de quadros, com o tempo abaixo de cada um
  • references/recipes.md: o índice de 36 receitas prontas para copiar, um arquivo cada em references/recipes/, desde pressionamento e popover até rolagem de números e texto em streaming
  • references/why.md: a razão por trás de cada regra, para quando um valor parecer arbitrário ou alguém quiser quebrá-la
  • references/gestures.md: arrasto, deslize, painéis, pontos de encaixe, momentum, elasticidade (sensação de telefone: antheo-mobile)
  • references/choreography.md: várias coisas como uma única mudança: fechamento de lacunas, reordenações, redimensionamento de painéis, crossfades
  • references/springs.md: molas em palavras simples, predefinições, uma mola JS de 30 linhas, linear() com fallbacks
  • references/performance.md: o que é barato de animar, 60fps em um telefone barato, como perfilhar
  • references/advanced.md: 3D, animação orientada por rolagem, View Transitions, filmagem de movimento
  • references/vocabulary.md: descrições simples para nomes de padrões para receitas
  • references/motion-kit.css: a cópia fallback do motion.css gerado
  • references/habits.md: o que a UI gerada erra aqui, cada um com sua correção

Habilidades Relacionadas