Communitygithub.com

motion-ui

Mostra ao agente como planejar, construir ou revisar "motion UI" de modo que o resultado concreto seja um design-system com tokens. O procedimento percorre Motion UI, Workflow e Non-negotiables. Use quando uma nova tarefa exigir esse tipo de craft.

O que é motion-ui?

Este skill fornece um playbook completo, baseado em pesquisa, para projetar e implementar animações e gestos em produtos digitais, focado em design systems com tokens. Ele é dividido em 19 arquivos de padrões que cobrem regras, antipadrões, referências boas e ruins, acessibilidade, tokens esqueleto de implementação e checklists. O workflow orienta passo a passo desde decidir se um elemento deve se mover, escolher o mecanismo (CSS transition, spring JS, View Transitions ou scroll-driven), definir timing através de tokens, posicionar no espaço, coreografar múltiplas animações e garantir performance, até revisar o resultado com uma rubrica de 18 itens, aceitando apenas notas acima de 80% sem nenhum "deve verificar" zerado. Os non-negotiables são regras rígidas que só podem ser quebradas com justificativa por escrito: cada animação deve ter um propósito nomeado, durações vindas de tokens (100/150/240/400 ms), springs escritos como duração + bounce, gestos interrompíveis com rastreamento 1:1 e projeção de velocidade, entradas nunca partindo de scale(0), toasts nunca sendo a única fonte de informação, e performance limitada a transform e opacity com `will-change` temporário. O skill suporta plataformas como Motion, React Spring, SwiftUI, Compose e Web nativa (View Transitions, scroll-driven animations), e prioriza acessibilidade (`prefers-reduced-motion`) sobre expressividade, e frequência sobre delight. As tabelas de decisão ajudam a escolher a abordagem certa baseada na frequência do evento, no tipo de interação e no papel do elemento na interface.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YehudaBriskman/fUdesIgn/tree/HEAD/plugins/motion-ui/skills/motion-ui

Perguntar na sua IA favorita

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

Documentação

Motion UI

Um playbook fundamentado em pesquisa para movimento e gestos em UI de produto: 19 arquivos de padrões, cada um com regras, antipadrões, referências boas e ruins, acessibilidade, tokens, um esboço de implementação e um checklist. Este arquivo fornece o fluxo de trabalho, os non-negotiables, as tabelas de decisão e os valores padrão de tokens. Abra os arquivos de padrão para aprofundamento.

  • Índice de padrões: references/INDEX.md lista todos os padrões com sua regra em uma linha.
  • Arquivos de padrão: references/patterns/<prefixo>-<nome>.md. Os prefixos são mfound (propósito, temporização, coreografia, movimento reduzido), mspring (molas), mgesture (arrasto, momentum, bordas, painéis, interrupção), mtrans (entrada/saída, origem espacial, transições de rota, micro-interações, impulsionado por rolagem), mperf (desempenho) e mref (rúbrica de revisão, antipadrões).
  • Tokens iniciais: assets/motion-tokens.css. Nomes e valores de duração, suavização e espaçamento correspondem ao tokens.css do dashboard-ui. Funciona sozinho em claro e escuro: os tokens de papel do dashboard-ui que ele lê são declarados com especificidade zero, então o tokens.css do dashboard-ui ou os tokens do próprio projeto nos mesmos nomes de papel os sobrescrevem em qualquer ordem de carregamento.
  • UIs de dados: para interpolação de números, transições de gráfico, exploração vinculada, recálculo ao vivo e estados de carregamento, use os padrões motion-* e prog-* do dashboard-ui. Este skill não os repete.

Fluxo de trabalho

  1. Decida se deve se mover. Nomeie o trabalho: feedback, continuidade, orientação, atenção ou (raramente) deleite. Estime com que frequência ocorre e se é acionado pelo teclado; então escolha a linha na tabela de frequência abaixo (mfound-purpose-and-frequency.md). Se não houver trabalho, ou a ação for acionada pelo teclado ou ocorrer 100+ vezes ao dia, pare: sem animação.
  2. Escolha o mecanismo.
    • De repouso a repouso e alternado (menus, diálogos, alternâncias): uma transição CSS (mfound-durations-and-easing.md), ou um token linear() de mola (mspring-css-linear-and-tokens.md).
    • Acionado por um dedo ou ponteiro, ou interrompível com velocidade: uma mola JS (mspring-parameters-and-mapping.md, mgesture-interruptibility-and-velocity.md).
    • Navegação: View Transitions (mtrans-view-transitions-and-routes.md).
    • Vinculado à posição de rolagem: animação impulsionada por rolagem (mtrans-scroll-driven-animations.md).
  3. Defina a temporização a partir de tokens. Duração por elemento, suavização por direção, saídas em 0,75× da entrada e molas como duração + bounce. Nunca use valores brutos em componentes.
  4. Posicione no espaço. Use transform-origin no gatilho, espelhe saídas, mantenha a consistência de ida e volta e deixe o chrome persistente parado (mtrans-spatial-origin-and-continuity.md). Para entrada/saída de elementos de camada superior, siga mtrans-enter-exit-top-layer.md.
  5. Para gestos, aplique em ordem:
    • Rastreamento 1:1 com um limiar de 10 px (mgesture-direct-manipulation-drag.md);
    • projeção e velocidade ao soltar (mgesture-momentum-projection-and-snap.md);
    • bordas com efeito elástico (mgesture-rubber-banding-and-bounds.md);
    • as regras de painéis e deslizar para dispensar (mgesture-sheets-and-swipe-to-dismiss.md).
  6. Coreografe quando várias coisas mudam: causa primeiro, depois pai, depois filhos; espaçamento de 20–40 ms, com limite (mfound-choreography-and-stagger.md).
  7. Torne barato. Anime apenas transform e opacidade, não use will-change global e pinte o feedback no próximo frame (mperf-compositor-will-change-and-inp.md).
  8. Escreva a versão de movimento reduzido como substituições, não remoções (mfound-reduced-motion-vestibular.md).
  9. Revise a partir de quadros.
    • Execute a passagem de antipadrões (mref-anti-patterns-gallery.md).
    • Capture tiras de quadros (desacelerado 4×, movimento completo e reduzido, mais uma execução interrompida) e a auditoria na página.
    • Pontue a rúbrica de 18 verificações (mref-motion-review-rubric.md). Envie com 80% ou mais e nenhum "deve verificar" com 0.
    • Relate cada descoberta como ID da verificação · evidência · correção, mais o que você não verificou.

Non-negotiables

Quebre um destes apenas com uma justificativa por escrito.

Se e por quanto tempo

  1. Toda animação tem um trabalho nomeado. Ações acionadas pelo teclado e ações 100+/dia não têm animação.
  2. A primeira resposta visual chega em até 100 ms da entrada, independentemente da duração da animação.
  3. As durações vêm de tokens (100 / 150 / 240 / 400 ms). Nada no chrome da UI passa de 400 ms; apenas momentos raros podem chegar a 600 ms.
  4. Entradas suavizam para fora; movimentos na tela suavizam entrada-saída; nenhum ease-in em nada que o usuário espera. Saídas têm cerca de 0,75× da entrada.

Molas e gestos

  1. Molas são escritas como duração + bounce. Use bounce 0 para chrome da UI, 0,1–0,2 apenas após um gesto com momentum, e nunca em opacidade, cor ou valores de dados.
  2. Elementos arrastados rastreiam o ponteiro 1:1 a partir do ponto de agarre, sem transição durante o arrasto. Comprometa-se com um arrasto após cerca de 10 px.
  3. Ao soltar, encaixe no alvo mais próximo da posição projetada e inicie a mola de estabilização na velocidade de liberação.
  4. Bordas têm efeito elástico; nada para bruscamente sob o dedo.
  5. Tudo que o usuário pode afetar é interrompível a partir de seu valor atual na tela. Não há filas de animação e nenhuma entrada é bloqueada durante o movimento. UI alternada usa transições, não keyframes.
  6. Ações de gesto destrutivas são confirmadas ao soltar e oferecem desfazer. Todo gesto tem um botão ou equivalente de teclado (WCAG 2.5.7).

Entrada, saída e navegação

  1. Nunca comece de scale(0). Entre de opacidade 0 mais escala 0,95–0,97 ou 8–24 px de deslocamento, com transform-origin no gatilho.
  2. Use @starting-style para entrada e display/overlay com allow-discrete para saída. O estado final visível é o padrão, para que navegadores não compatíveis ainda funcionem.
  3. Transições de rota são melhoria progressiva. Prepare os dados primeiro, depois faça a transição. Use o cross-fade padrão ou um deslocamento direcional de 16–24 px por tipo de transição, nomeie 1–3 elementos compartilhados e mova o foco depois.
  4. Toasts nunca seguram a única cópia da informação. Erros nunca desaparecem automaticamente; um Toast de desfazer fica pelo menos 8 s e sua ação também existe fora do toast. Temporizadores pausam ao passar o mouse, focar e em abas ocultas (dashboard-ui comp-notifications-alerts.md).

Desempenho e segurança

  1. Anime apenas propriedades da família transform e opacidade em qualquer coisa maior que um controle pequeno. Sem transition: all. will-change é temporário e só segue uma medição.
  2. Sob prefers-reduced-motion: reduce, substitua o movimento espacial por um fade de 150 ms ou menos, mantenha feedback, mantenha rastreamento de arrasto 1:1 e remova bounce. Nunca envie um kill switch global de 0.01ms, e animações JS também devem respeitar a configuração.
  3. Sem paralaxe, sequestro de rolagem, zoom em tela cheia ou animação em loop ociosa na UI do produto. Reprodução automática acima de 5 s tem um controle de pausa, e nada pisca mais de 3 vezes por segundo.
  4. Revise o movimento a partir de quadros capturados, não do código ou da memória.

Tabelas de decisão

Frequência → movimento (mfound-purpose-and-frequency.md)

Com que frequênciaMovimento
Acionado pelo teclado, ou 100+ vezes ao dia (ponto de corte do skill)Nenhum
Dezenas de vezes ao dia100–150 ms fade, talvez uma escala pequena; sem movimento, sem bounce
Algumas vezes por sessão150–240 ms, pode mover 8–24 px
Raro (primeira execução, grande sucesso)Até 400–600 ms, uma mola com bounce permitido

Mecanismo (mspring-parameters-and-mapping.md, mspring-css-linear-and-tokens.md)

SituaçãoUse
Cor, opacidade, mudança de estadoTransição CSS, linear ou ease-out
Elemento alternado que pode ser revertido no meio do caminhoTransição CSS (nunca keyframes)
Movimento espacial de repouso a repouso com sensação de molaToken CSS linear() de mola com sua própria duração
Liberação após arrasto ou lançamento, ou redirecionamento com velocidadeMola JS (Motion, React Spring, SwiftUI, Compose)
Mudança de layout (reordenar, redimensionar, expandir)FLIP, Motion layout ou uma View Transition
Mudança de página ou rotaView Transition (mesmo ou entre documentos)
Progresso através de um roladorAnimação impulsionada por rolagem

Duração e suavização por elemento (mfound-durations-and-easing.md)

ElementoDuraçãoCurva
Pressionamento, alternância, hover100 msease-out (pressionar escala 0,97)
Tooltip, menu, popover150 ms in / 110 ms outease-out in, ease-in ou fade out
Diálogo, toast240 ms in / 180 ms outease-out in, ease-in ou fade out
Painel, gaveta240–400 ms--motion-ease-drawer, ou uma mola após arrasto
Transformação de contêiner (cartão → detalhe)400 msenfatizada
Cross-fade de rota150–250 mslinear

Predefinições de mola (mspring-parameters-and-mapping.md)

TokenDuração / bounceUso
spring-fast0,24 s / 0alternâncias, controles pequenos
spring-default0,3 s / 0menus, estabilização de painel, layout
spring-slow0,45 s / 0superfícies de tela cheia
spring-snappy0,3 s / 0,15liberação após um toque, encaixes
spring-playful0,4 s / 0,3deleite raro apenas

Parâmetros de bibliotecas (Motion, React Spring, SwiftUI, Material 3) vêm de uma fórmula em mspring-parameters-and-mapping.md.

Limiares de gesto (mgesture-*)

ValorPadrão
Início de arrasto / trava de eixo10 px
Janela de amostragem de velocidade100 ms
Desaceleração de projeção0,998 por ms (0,99 para paginação rápida)
Toque confirma> 400 px/s
Fechamento de painel> 25% de sua altura arrastada, ou um toque
Constante de efeito elástico0,55 (a aproximação comum)

Valores padrão de token

Conjunto completo em assets/motion-tokens.css.

GrupoPadrões
Duraçãoinstant 0 · micro 100 · short 150 · medium 240 · long 400 ms · proporção de saída 0,75
Suavizaçãostandard cubic-bezier(0.2,0,0.38,0.9) · enter (0,0,0.38,0.9) · exit (0.2,0,1,0.9) · emphasized (0.2,0,0,1) · drawer (0.32,0.72,0,1)
Molas (CSS)--motion-spring-{fast,default,slow,snappy,playful} com -dur correspondente (360 / 450 / 670 / 420 / 660 ms)
Geometriaescala-de 0,96 · pressionar 0,97 · distância 8 / 16 / 24 px
Coreografiaespaçamento 30 ms · máximo 300 ms (150 ms em menus)
Movimento reduzidotokens espaciais colapsam para 0 ou 1; fades mantêm sua temporização

Como aplicar este skill

  • Ao construir:
    • Carregue assets/motion-tokens.css, ou mapeie-o nos tokens do projeto.
    • Prefira recursos da plataforma: transições CSS, @starting-style, <dialog> e a API popover, View Transitions, animações impulsionadas por rolagem, linear(). Recorra a uma biblioteca JS apenas para gestos e velocidade.
    • Nunca use o tipo TypeScript any.
  • Ao revisar: capture quadros primeiro, depois execute a galeria de antipadrões e a rúbrica. Relate uma tabela de verificação, pontuação, evidência e correção, ordenada por severidade, e liste o que você não verificou.
  • Quando o projeto tem um sistema de movimento (M3, Carbon, seus próprios tokens): os tokens do projeto vencem. Mapeie-os nestes papéis e sinalize as lacunas.
  • Quando as regras conflitam: acessibilidade e controle do usuário (movimento reduzido, interrompibilidade, sem sequestro de rolagem) vencem a expressividade, e frequência vence o deleite.

Individual skills in this repo

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

Habilidades Relacionadas