Communitygithub.com

gsap-motion

Arquitetura de animação GSAP 3 para sites premium — registro de plugins (ScrollTrigger, SplitText, Flip, Observer, Draggable, Inertia, CustomEase, MorphSVG, DrawSVG — todos gratuitos no pacote público do gsap), integração com React via useGSAP com escopo e limpeza, gsap.matchMedia para ramos responsivos e de movimento reduzido, timelines, sequências fixas com scroll, revelações de texto, transições de clip-path/máscara, morphs de layout com Flip, scroll horizontal, parallax, efeitos magnéticos/cursor e transições de página. Use para qualquer trabalho com GSAP ou ScrollTrigger, qualquer animação impulsionada por scroll ou cinematográfica, e sempre que animações vazarem, duplicarem, travarem ou quebrarem após mudanças de rota ou redimensionamentos.

O que é gsap-motion?

Este skill fornece uma arquitetura completa e testada para animações GSAP 3 em sites premium, com foco em React e Next.js. Ele padroniza o uso do hook `useGSAP` para garantir que todas as animações sejam revertidas corretamente ao desmontar componentes, prevenindo vazamentos de memória e bugs comuns. Inclui um registro centralizado de plugins (todos gratuitos no pacote público), tokens de movimento, um hook para `prefers-reduced-motion` e exemplos práticos de padrões como sequências fixas com scroll, revelações de texto, morphs de layout com Flip e transições de página. O skill resolve problemas recorrentes como animações que duplicam, travam ou quebram após mudanças de rota, redimensionamento ou em modo estrito do React, oferecendo regras claras e receitas testadas para criar animações performáticas e acessíveis.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/jakyherr05-hash/Claude-code-skill/tree/HEAD/plugins/premium-web-studio/skills/gsap-motion

Perguntar na sua IA favorita

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

Documentação

Arquitetura de movimento GSAP

Linha de base verificada (2026-11-15)

  • [email protected] é a versão mais recente no npm. Seu campo de licença é "Standard 'no charge' license" (gsap.com/standard-license): gratuita para sites comerciais, incluindo trabalho para clientes. O único uso proibido é criar ferramentas visuais de construtor de animação sem código que concorram com o Webflow. Todos os plugins são enviados no pacote público: ScrollTrigger, ScrollSmoother, SplitText, Flip, Observer, Draggable, InertiaPlugin, CustomEase, CustomBounce, CustomWiggle, MorphSVGPlugin, DrawSVGPlugin, MotionPathPlugin, ScrambleTextPlugin, ScrollToPlugin, Physics2D, PhysicsProps, GSDevTools, e mais.
  • @gsap/[email protected] fornece useGSAP.
  • Verifique novamente antes de um novo projeto: npm view gsap version license e ls node_modules/gsap/*.js.
  • Use ScrollSmoother ou Lenis, nunca ambos. Este estúdio padroniza o Lenis (skill lenis-scroll).

Arquitetura (copie assets/ para src/motion/)

ArquivoFunção
assets/registry.tsRegistra plugins uma vez, cria os CustomEases do projeto, define padrões, ScrollTrigger.config({ ignoreMobileResize: true }). Tudo importa gsap daqui.
assets/tokens.tsTokens de movimento (durações, eases, staggers) espelhados de ANIMATION_SPECIFICATION.md + prefersReducedMotion()
assets/lit.tsExemplo de primitiva de texto reutilizável: SplitText com aria:'auto', autoSplit, e onSplit retornando o tween. Adapte a revelação à marca (lit, mascarada, deslizada…).
assets/useReducedMotion.tsHook prefers-reduced-motion ao vivo para alternâncias no nível do DOM (ex.: renderizar etapas estáticas em vez de um pin)
assets/examples/*.tsxPadrões testados da demo de referência: sequência fixa com scroll (Method), filtro Flip (ScheduleIndex), interativo com quickTo (TheHour), revelações ao aparecer (Rooms), véu de transição de rota (Router)

Esses arquivos são a implementação verificada de demo/ neste repositório, exercitada por sua suíte Playwright (limpeza entre rotas, movimento reduzido, sincronização de scroll).

Regras que previnem 90% dos bugs de GSAP no React

  1. Toda animação vive dentro de useGSAP(() => {...}, { scope: ref }). O contexto reverte todos os tweens, ScrollTriggers, SplitTexts e ramos matchMedia ao desmontar. Animações em manipuladores de evento usam contextSafe.
  2. Nunca crie ScrollTriggers no escopo do módulo ou em useEffect simples sem revertê-los. Nunca chame ScrollTrigger.killAll() como estratégia de limpeza.
  3. Um gsap.matchMedia() por seção com condições motion/reduce (e desktop/mobile). Estados ocultos iniciais são definidos dentro do ramo motion, para que usuários sem JS e com movimento reduzido vejam o conteúdo final.
  4. Seguro no modo estrito: useGSAP lida com a dupla invocação do React 18/19. Verifique com uma checagem de vazamento: ScrollTrigger.getAll().length retorna ao valor inicial após navegar para longe e voltar.
  5. Atualize após mudanças de layout: após o carregamento de fontes (document.fonts.ready.then(() => ScrollTrigger.refresh())), após filtrar listas, e após o conteúdo da rota montar. Use invalidateOnRefresh: true em qualquer trigger cujos valores sejam calculados a partir do layout.
  6. Fixação correta: fixe um wrapper interno, mantenha pinSpacing, dê a ele um min-height: 100svh que não dependa de webfonts, e use anticipatePin: 1 com Lenis. Use um pin por experiência; pins empilhados confundem os usuários.
  7. Anime propriedades baratas: transform, opacity, clip-path; variáveis CSS apenas em pequenas subárvores. Evite width/height/top/left em timelines com scroll, e leia o layout antes de escrever (GSAP agrupa suas próprias escritas).
  8. will-change apenas enquanto anima, e apenas em poucas camadas.

Receitas

references/recipes.md tem padrões testados ou documentados para: sequência hero cinematográfica, revelações de SplitText (chars/words/lines, mascarados), transições de clip-path e máscara, narrativa com pin e scroll, seção de scroll horizontal (containerAnimation), camadas de parallax, morphs de estado Flip, seções de gestos orientadas por Observer, carrosséis Draggable + Inertia, botões magnéticos, seguidores de cursor, morph/draw SVG, distorção de imagem com passagem para WebGL, transições de página, e scroll 3D com câmera WebGL.

references/react-lifecycle.md cobre mudanças de rota, redimensionamento, mudanças de conteúdo e depuração de vazamentos.

Lista de verificação de movimento intencional (antes de animar)

  • O que esta animação comunica (hierarquia, causalidade, estado, material da marca)? Se nada, delete-a.
  • É o momento de destaque, ou deve permanecer sutil?
  • O que o movimento reduzido mostra em vez disso? (Deve permanecer totalmente compreensível.)
  • Qual é a expressão para mobile? (Efeitos de hover precisam de uma alternativa de toque; pins ficam mais curtos.)
  • Quantos ScrollTriggers a página cria? Escreva o inventário na especificação para que o QA possa verificá-lo.

Habilidades Relacionadas