Communitygithub.com

Seenry Motion

Constrói, revisa ou pesquisa animações de interface: feedback de pressionamento, menus, tooltips, diálogos, folhas, notificações, acordeões, abas, transições de página e elementos compartilhados, efeitos de rolagem, arrastar e gestos, mudanças numéricas e de ícones.

O que é Seenry Motion?

Seenry Motion é uma skill detalhada e rigorosa para projetar e implementar animações de interface do usuário, focada em clareza de propósito e execução técnica precisa. Ela fornece um processo de construção sequencial que começa com a decisão sobre se algo deve ou não animar, baseado na frequência de exposição ao usuário, e nomeia o propósito da animação em uma palavra (feedback, orientação, estado, continuidade, explicação ou deleite). A skill prescreve ferramentas específicas (desde transições CSS até a API Web Animations e a biblioteca Motion) e propriedades limitadas (translate, scale, rotate, opacity, clip-path, filter), além de curvas e durações adequadas para cada tipo de movimento, com ênfase em interrupção e comportamento de movimento reduzido. Ela também inclui receitas modernas de CSS testadas, ativos executáveis para cenários comuns (como menus, diálogos e transições de número), e critérios de avaliação para alcançar um nível de qualidade premium (nota 9), abordando problemas recorrentes que impedem animações simplesmente corretas de se tornarem excepcionais. A skill é suportada por uma série de referências e padrões, e é parte do repositório Seenry, sendo útil para engenheiros de front-end e designers de interação que buscam consistência e excelência em animações de interface.

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

Perguntar na sua IA favorita

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

Documentação

O que Seenry Motion faz?

A movimento existe para explicar uma mudança: de onde algo veio, o que a entrada fez, em que estado a interface está agora. Construa cada animação através da sequência abaixo, em ordem; as etapas 1 e 2 decidem se algum código será escrito.

Tome a decisão e declare-a em uma linha; não ofereça um menu de opções de movimento. Estenda os tokens e componentes de movimento existentes do projeto, em vez de adicionar um conjunto paralelo.

A sequência de construção

1. Deve animar? Decida pela frequência.

Com que frequência as pessoas veemDecisão
100+ vezes ao dia (menu de comandos, atalhos de teclado, navegação de lista com setas)Sem animação. Instantâneo.
Dezenas de vezes ao dia (hover, abas, alternâncias)≤150ms em opacidade e cor apenas, ou nada
Ocasionalmente (menus, diálogos, folhas, notificações)Movimento padrão da tabela abaixo
Raramente (onboarding, primeiro sucesso, momentos de vazio para cheio)Espaço para personalidade

Ações acionadas por teclado nunca esperam por animação. Se a regra disser não, diga e entregue a mudança de estado instantânea.

2. Nomeie o propósito em uma palavra: feedback, orientação (de onde veio ou para onde foi), estado, continuidade (evitar um salto brusco), explicação (apenas marketing e onboarding) ou deleite (apenas momentos raros). Sem propósito, sem animação. Dados que as pessoas estão lendo nunca se movem por estilo.

3. Escolha a ferramenta mais barata que funciona.

NecessidadeFerramenta
Hover, pressionamento, cor, alternância de classe ou atributoCSS transition
Entrada na montagem, saída antes de display: none, <dialog> e popover nativosCSS transition + @starting-style + allow-discrete
Altura para autointerpolate-size: allow-keywords, ou a trilha de grid 0fr → 1fr
Mudanças de rota, lista → detalhe, indicadores de morfismoView Transitions API
Efeitos vinculados à rolagemanimation-timeline: view() / scroll()
Programático, cancelável, sem bibliotecaWeb Animations (element.animate)
Molas com velocidade, animação de layout, gestos, presença em ReactMotion (motion.dev)
Um componente inteiro (notificação, gaveta, menu de comando, select)Uma biblioteca mantida, veja libraries

4. Escolha as propriedades. Apenas translate, scale, rotate, opacity, clip-path, filter. Nunca entre de scale(0): comece em 0.95–0.97 com opacidade 0. Popovers escalonam a partir do seu gatilho (transform-origin no lado do gatilho); diálogos escalonam do centro. Translados percentuais (translate: 0 100%) movem pelo tamanho próprio do elemento.

5. Escolha a curva e duração, ou uma mola.

MovimentoDuraçãoSuavização
Feedback de pressionamento100–160ms--ease-out
Tooltip, pequeno popover120–200ms--ease-out
Menu, dropdown, select150–250ms--ease-out
Diálogo200–250ms--ease-out
Folha, gaveta350–500ms--ease-drawer
Elemento cruzando a tela, morfismos250–400ms--ease-in-out
Cor, fundo, borda em hover150msease
Progresso, marquee, preenchimento de segurar-para-confirmarenquanto durar o trabalholinear

--ease-out: cubic-bezier(0.23, 1, 0.32, 1), --ease-in-out: cubic-bezier(0.77, 0, 0.175, 1), --ease-drawer: cubic-bezier(0.32, 0.72, 0, 1). Nunca ease-in em movimento de interface: atrasa exatamente o momento que as pessoas estão observando. Prefira UI de produto abaixo de 300ms; viagens mais longas de folha precisam de uma razão. Saídas são muitas vezes ~20–30% mais rápidas que entradas, a menos que preservar uma relação de manipulação direta ou espacial justifique o mesmo tempo. Use uma mola para qualquer coisa que o usuário arraste, lance ou possa reverter no meio do caminho: Motion {type: "spring", duration: 0.5, bounce: 0.2} (bounce 0 para UI de produto, ≤0.3 para lúdico), ou as molas CSS linear() em recipes.

6. Planeje interrupção e saída. Prefira transições CSS para mudanças reversíveis de propriedade, pois elas redirecionam do valor atual. Quando geometria ou coreografia precisar de WAAPI, capture o estado renderizado atual, cancele ou redirecione animações próprias e proteja contra conclusão obsoleta. Uma segunda entrada reverte ou substitui a solicitação antiga, em vez de enfileirar atrás dela. Publique o novo estado lógico imediatamente; um estado de apresentação separado pode manter uma saída pintada.

Refine a mudança interrompida. Use essas verificações onde elas se encaixam no componente. São heurísticas de design, não uma pontuação garantida. Experimente entradas repetidas durante entrada e saída, incluindo com 50–150ms de intervalo; registre temporizações reais ao fazer alegações de tempo.

  • Mantenha continuidade e semântica. Abas, filtros ou estados de status relacionados podem compartilhar uma célula de grid (display:grid, grid-area:1/1) e transitar opacidade ou um pequeno translate. Mantenha conteúdo inativo fora da ordem de foco e da árvore de acessibilidade; montado não significa interativo. Uma fase de saída rápida (aproximadamente 65–90ms) e entrada de 120–160ms podem ser um ponto de partida, não uma receita obrigatória. Desmonte ou esconda apenas quando a transição atual o permitir; uma conclusão obsoleta nunca deve esconder um estado mais novo. WAAPI explicitamente cancelável e saídas de diálogo nativo protegidas são alternativas válidas.
  • Mantenha o resultado compreensível. Evite intervalos em branco acidentais ou texto concorrente ilegível. Escolha sobreposição, um pequeno crossfade ou uma substituição instantânea com base no conteúdo; um desbotamento de rótulo inteiro pode ser mais seguro do que mover texto através de arte. Preserve uma dica estática apropriada enquanto o movimento estiver indisponível ou reduzido. Inspecione a legibilidade real em vez de usar um limiar de opacidade como prova.
  • Uma cópia de uma coisa viajante. Quando um título, avatar ou capa se move para um novo lugar, evite pintura duplicada visível. Esconda o destino até que o viajante aterrisse, então retire a cópia temporária. Trace o texto contra a arte e a casca móvel; um ponto final sem recorte não prova um caminho legível.
  • O rótulo concorda com seu resultado. Um rótulo como "Marcar como pago" tornando-se "Pago" segue o mesmo estado de aplicação aceito que seu resultado. Reserve seu espaço quando útil e evite texto obsoleto ou rótulos duplicados focalizáveis. Não atrase um estado de sucesso real apenas para terminar a decoração.
  • Sequências podem ser canceladas. Demonstrações de digitação, revelações em etapas e repetições compartilham um proprietário para etapas pendentes. Pausa, reversão e nova entrada cancelam trabalho obsoleto e redirecionam o movimento visível de seu estado atual. Um timeout obsoleto não deve retomar uma sequência pausada ou sobrescrever conteúdo mais novo.
  • Libere animações finalizadas. Estabeleça o estado final através de CSS ou estilos confirmados, então libere animações WAAPI finitas próprias quando apropriado. fill:forwards não deve continuar sobrescrevendo mudanças de estado posteriores. Verifique animações inesperadas após a interação se estabelecer, enquanto permite um indicador de carregamento intencional em andamento até seu trabalho terminar.
  • Cada movimento explica uma relação. Menus crescem a partir de seu gatilho, painéis de sua borda, e conteúdo relacionado move-se consistentemente com a navegação. Use as faixas de duração acima como pontos de partida; mantenha a resposta percebida imediata e justifique viagens mais longas. Teste interrupção e movimento reduzido em vez de tratar uma duração fixa como prova de qualidade.

Alcançando 9. No juiz de movimento, 7 é correto mas genérico, 8 é claramente premium e 9 é distintivo ao nível da Apple ou Linear. Rodadas estagnam em 7–8 pelas mesmas poucas razões. Resolva todas antes de gastar uma rodada:

  • Um componente de cada vez. Julgue cada componente sozinho com --labels "<Linha>" até pontuar 9, e mantenha a melhor versão de cada. Um catálogo geral segue suas linhas mais fracas, então consertar muitas linhas ao mesmo tempo nunca o move, e uma mudança que abaixa uma linha é revertida mesmo quando o juiz a sugeriu.
  • Aplique cada correção, não apenas a principal. Itens pequenos que recorrem (feedback de hover, pressionamento e fechamento) seguram states em 7 rodada após rodada. --prev <last motion.json> lista os critérios que não subiram e as interações pedidas para corrigir novamente; check.mjs passa isso automaticamente.
  • Um problema que retorna após sua correção é estrutural. Re-temporização não pode consertar um caminho que cruza. Elementos compartilhados mantêm seu arranjo relativo entre estados: um título abaixo de sua capa permanece abaixo dela na visualização de detalhes, então nenhum passa pelo outro.
  • Sem quadros vazios. Em cada momento filmado (30–320ms) a região alterada mostra conteúdo real. Uma casca carrega seu conteúdo conforme cresce; uma resposta em streaming cresce a partir de suas primeiras palavras. Nunca mostre uma caixa de resposta em branco ou um esqueleto que espera e depois se dissolve.
  • Uma ideia trabalhada por componente. O que persiste viaja e o que é novo nasce de sua causa. Um fade, um translate de 4px e uma troca de rótulo pontuam 7.
  • Feche onde abriu. Uma superfície que abre de um controle fecha do mesmo ponto: o controle se torna (ou é substituído no lugar por) seu fechamento, então a mão nunca viaja. Não precisa manter a mesma cor; mantém o lugar e o tamanho.
  • Uma única rodada não é uma pontuação. Uma rodada do juiz (ela mesma uma mediana de três) move por um ponto em código inalterado. Aceite um 9 apenas quando duas rodadas separadas ambas o alcançarem, e compare versões no mesmo número de rodadas.

7. Entregue movimento reduzido e bloqueio de entrada com ele. Sob prefers-reduced-motion: reduce, remova movimento, paralaxe, desfoque e loops; mantenha mudanças curtas de opacidade que ajudam na compreensão. Bloqueie movimento em hover com @media (hover: hover) and (pointer: fine). Cada mudança de estado animada também deixa uma dica estática (rótulo, ícone, cor) para quando o movimento não for executado.

Receitas

Comece de recipes para feedback de pressionamento, menus e popovers, tooltips, diálogos, folhas, notificações, acordeões, entradas escalonadas, indicadores de aba, transições de página e elementos compartilhados, revelações de rolagem, trocas de ícone, mudanças numéricas, segurar-para-confirmar, arrastar-para-dispensar (com projeção de velocidade e elasticidade), mascaramento crossfade, troca de tema e supressão de primeira renderização. As receitas CSS nativas são exercitadas no Chromium pelos testes do pacote.

Ativos executáveis

Mudança solicitadaRota focada
Menu de ação ou rótulo de status curtoOriginal menu de ação, alternância de status e transições de produto. Se o menu for solicitado a animar aberto e fechado, preserve sua superfície através da fase de fechamento; desmontagem condicional ao fechar pula essa fase. Para uma transição de status, mova o texto em um slot reservado; uma substituição de texto simples ou mudança de cor de ponto sozinha é incompleta. A aplicação possui a ação real.
Divulgação em fluxo ou geometria mutávelOriginal cartão expansível, ajudante de geometria e padrões de superfície. Preserve o foco e redirecione da geometria atual.
Tarefa modal focadaOriginal superfície modal e padrões de superfície. Use um diálogo nativo para comportamento de camada superior e foco; permita que a saída termine antes de fechar, e faça a reversão cancelar o fechamento pendente.
Mudança de número ou íconeTransições de número e adaptadores. Para uma contagem de inteiros pequena, prefira o ajudante de contagem-pop original em vez de reconstruir semântica de dígito. Mantenha um valor acessível real; não esconda cada dígito e coloque aria-label em um <strong> simples. Uma transição de dígito precisa de movimento por lugar; mantenha unidades ancoradas.
Entrada ou saída de voz ao vivoOriginal presença de voz aceita estado de propriedade da aplicação e um nível de áudio normalizado. Mantenha controles e anúncios no DOM; um sinal de demonstração gerado não é atividade de microfone.
Presença de carregamento ou processoOriginal campo de sinal, traço de limite e padrões de carregamento. Tempo de animação não é progresso.
Imagem decodificada ou material expressivoOriginal revelação de imagem, superfícies sólida reflexiva e de borda, inclinação de ponteiro, efeitos de superfície e efeitos expressivos. Mantenha conteúdo útil enquanto uma substituição carrega; use reflexão e inclinação apenas onde o material tem um propósito.
Projetar qualquer novo componente interativo (brief, grafo de estado, pontuação de movimento, contrato de entrada, checklist)Artesanato de interação
Pilha de notificações ou bannersPadrões de feedback e original reducer de notificação. Remova overflow do estado ativo antes de sua saída; teste o quarto evento em uma pilha de três itens.
Marco ocasional concluídoOriginal explosão de confirmação. Registre o sucesso no estado da aplicação primeiro, depois toque a decoração finita; o resultado final deve permanecer visível após ela limpar.
Abas selecionadas ou mudança de página ordenadaOriginal superfície de seleção para um destaque compartilhado e estágio direcional para visões relacionadas; a aplicação possui seleção, painéis, rota e histórico. Use padrões de navegação para outras estruturas.
Rolagem ou um sistema coordenadoCoreografia de rolagem, pontuações trabalhadas, coreografia de sistema e o índice de movimento.

Selecione apenas o guia e ajudante necessários para esta mudança. Os ativos originais agrupados são pontos de partida reutilizáveis, não substitutos automáticos para um componente fonte nomeado ou prova de fidelidade a ele. Mantenha licenças com qualquer tempo de execução de terceiros copiado; os ativos Seenry originais usam a licença MIT do repositório.

Nunca envie

NuncaEm vez disso
Animação em uma ação de 100+/dia ou acionada por tecladoMudança instantânea
transition: allNomeie propriedades específicas

Habilidades Relacionadas