Communitygithub.com

scroll-motion

Adicione animações acionadas pela rolagem e de entrada a um site com GSAP, ScrollTrigger e Lenis, incluindo revelações, parallax, seções fixas, rolagem horizontal, desenho de linhas, contadores e pré-carregadores.

O que é scroll-motion?

Esta Skill fornece um conjunto completo de padrões de animação acionada pela rolagem e de entrada usando GSAP, ScrollTrigger e Lenis, visando criar experiências de site 'premium'. Ela categoriza os efeitos por propósito (revelar uma seção, mostrar itens que pertencem juntos, dar profundidade, etc.) e fornece trechos de código prontos para cada um, além de regras rígidas de desempenho (animar apenas transform e opacidade, durações e easing padronizados) e acessibilidade (respeitar prefers-reduced-motion). A Skill também cobre boas práticas como refrescar ScrollTrigger após carregamento de fontes e imagens, desabilitar rolagem suave no mobile por padrão, e evitar mais de uma 'peça central' fixa ou horizontal por página. Funciona com qualquer site que possa incluir os scripts CDN ou auto-hospedados, e o arquivo `references/snippets.md` contém exemplos copiáveis. Para sites muito simples, a própria Skill reconhece que uma IntersectionObserver com transição CSS pode ser suficiente, evitando o peso de ~70 KB da biblioteca.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/imperfec-t/webcraft/tree/main/skills/scroll-motion

Perguntar na sua IA favorita

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

Documentação

Scroll motion

Movimento deve explicar estrutura: o que é novo, o que pertence junto, o que olhar em seguida. Animação que não faz nada disso é decoração e custa desempenho, então cada efeito abaixo está ligado a um propósito.

Configuração

<script defer src="https://cdn.jsdelivr.net/npm/gsap@3/dist/gsap.min.js"></script>
<script defer src="https://cdn.jsdelivr.net/npm/gsap@3/dist/ScrollTrigger.min.js"></script>
<script defer src="https://cdn.jsdelivr.net/npm/lenis@1/dist/lenis.min.js"></script>
<script defer src="/js/main.js"></script>

defer impede que os scripts bloqueiem a primeira pintura e ainda os executa em ordem, então main.js (o código abaixo) enxerga gsap. Para produção, fixe versões exatas ([email protected]) ou hospede os arquivos localmente.

gsap.registerPlugin(ScrollTrigger);

const reduce = matchMedia("(prefers-reduced-motion: reduce)").matches;
if (!reduce) {
  const lenis = new Lenis({ duration: 1.1, smoothWheel: true });
  lenis.on("scroll", ScrollTrigger.update);
  gsap.ticker.add((t) => lenis.raf(t * 1000));
  gsap.ticker.lagSmoothing(0);
}

Envolva toda animação em if (!reduce) ou use gsap.matchMedia(). Pessoas com distúrbios vestibulares definem essa preferência por um motivo, e o conteúdo deve estar totalmente visível sem movimento.

Escolhendo um efeito

PropósitoEfeitoSeção de referência
Anunciar uma nova seçãoRevelação de título mascaradaRevelações
Mostrar itens que pertencem juntosFade-up escalonadoRevelações
Adicionar profundidade a imagensParallax, revelação com clip-pathImagens
Contar uma sequênciaEtapas fixas, linha desenhadaFixação
Mostrar um portfólioRolagem horizontalFixação
Enfatizar um númeroContagem crescenteDetalhes
Cobrir carregamento inicialPré-carregadorDetalhes

Código copiável para cada um está em references/snippets.md. Leia-o quando estiver prestes a implementar um efeito; você não precisa dele para planejar.

Regras da casa

  • Anime apenas transform e opacity. Animar top, width, margin ou box-shadow aciona layout ou pintura a cada quadro e causa gagueira em celulares de gama média.
  • Durações: 0,6 a 1,0s para revelações, 0,2 a 0,3s para hovers. Mais longo parece lento na segunda visita.
  • Easing: power3.out para entradas, power2.inOut para transições, none para animações rastreadas (scrub fornece o easing).
  • Stagger: 0,06 a 0,12s. Limite o total: com 12 cartões, escalone os primeiros 6 e agrupe os restantes.
  • Reproduza uma vez. Use once: true ou toggleActions: "play none none none". Re-animar a cada volta da rolagem é cansativo.
  • Uma peça central por página. Uma seção fixa ou horizontal é memorável uma vez e exaustiva três vezes.
  • Defina estado inicial em JS, não em CSS. Se o script falhar ao carregar, conteúdo oculto por CSS fica escondido para sempre.
  • Atualize após mudanças no layout: chame ScrollTrigger.refresh() depois que fontes e imagens carregarem, ou as posições dos gatilhos se deslocam.
window.addEventListener("load", () => ScrollTrigger.refresh());
document.fonts?.ready.then(() => ScrollTrigger.refresh());

Mobile

  • Desabilite fixação e rolagem horizontal abaixo de 768px com gsap.matchMedia(); empilhe o conteúdo normalmente.
  • Rolagem suave do Lenis em toque frequentemente luta contra a inércia nativa. Deixe a rolagem por toque nativa (o padrão) a menos que a pessoa insista.
  • Reduza as distâncias de parallax pela metade em telas pequenas.

Depuração

  • Adicione markers: true a um ScrollTrigger para ver as linhas de início e fim.
  • Pulo no início da fixação geralmente significa que o elemento fixo tem um pai com transform ou altura variável.
  • Animação dispara cedo demais: imagens acima carregaram tarde. Defina width e height explícitos nas imagens.
  • Nada anima: verifique se o plugin está registrado e o seletor corresponde.

Sem GSAP

Para simples fade-ups em um site pequeno, um IntersectionObserver adicionando uma classe mais uma transição CSS é suficiente e economiza cerca de 70 KB. Veja a última seção de references/snippets.md.

Individual skills in this repo

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

hero-section

Design and build the hero (first screen) of a website, including headline layout, media treatment, CTA, proof badge, marquee and entrance animation. Use this whenever someone asks for a hero section, a landing page header, "the top of my homepage", a cinematic or animated intro, a video background, a text marquee, or says their first screen looks plain or generic.

homepage-blueprint

Plan the section structure and content slots of a homepage for an agency, freelancer, studio or service business before any design or code. Use this whenever someone asks "what sections should my homepage have", "plan my website", "structure a landing page for my business", wants a wireframe or sitemap for a service site, or starts building a homepage without a clear outline.

responsive-layout

Build page layouts that work from phones to wide desktops using CSS grid, flexbox, container queries and fluid sizing, including card grids, bento grids, split sections, sticky sidebars and navigation that collapses. Use this whenever someone says their site "breaks on mobile", asks for a responsive grid, a bento layout, a mobile menu, fixing horizontal scroll or overflow, or is laying out any multi-column section.

website-workflow

Plan and sequence a whole website build, from structure through design, code, WordPress and launch, by routing each stage to the right webcraft skill. Use this when someone asks to "build me a website", "design my site from scratch", "redo our homepage", wants an end-to-end plan for a marketing, agency, studio or service site, or the request spans more than one of structure, look, layout, motion, CMS and QA.

Habilidades Relacionadas