Communitygithub.com

Im-Fran/landing-skills

Use ao adicionar animações, efeitos de scroll, parallax, transições de página, interações de hover ou cursor, 3D, WebGL, shaders ou partículas a uma landing page, ou ao escolher entre GSAP, Motion, Lenis, Three.js, React Three Fiber, Rive ou Lottie.

O que é landing-skills?

Esta skill é um guia completo e profissional para adicionar movimento e 3D a landing pages que já funcionam sem eles. Ela estabelece princípios rigorosos: todo efeito deve ter um propósito declarado, uma variante de movimento reduzido e um fallback que mantenha a página completa. A skill assume que a página estática original (construída por `landing-skills:landing-build`) é o fallback padrão – se um script falhar, o navegador não tiver suporte ou o visitante preferir menos movimento, a página deve permanecer funcional e legível, sem depender de JavaScript para exibir conteúdo essencial. A skill é especialmente útil para desenvolvedores que querem evitar padrões genéricos de “página animada” e criar experiências de movimento que realmente demonstram o produto, com foco em acessibilidade, desempenho e segurança. Ela suporta React (Vite, Next) e JavaScript vanilla, e oferece referências para efeitos específicos (entradas de texto, scroll, parallax, interações, 3D/WebGL, shaders e partículas), sempre priorizando CSS e scripts leves antes de bibliotecas pesadas.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Im-Fran/landing-skills/tree/HEAD/skills/landing-motion

Perguntar na sua IA favorita

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

Documentação

Movimento na landing page

Adicione movimento e 3D a uma landing page que já funciona sem eles. Cada efeito que você adicionar tem um propósito declarado, uma variante de movimento reduzido e um fallback que mantém a página completa. A página antes de você começar é o fallback: se um script falhar, o navegador não tiver um recurso, ou o visitante solicitar menos movimento, eles recebem essa página, não uma página em branco.

Entradas

  1. landing/direction.md, seção Intenção de movimento e 3D. Este é o briefing para o seu trabalho. Diz none ou nomeia cada momento e para que ele serve. Implemente o que ele nomeia. Não adicione momentos que ele não nomeia.
  2. A página estática construída por landing-skills:landing-build, ou qualquer página existente. Ela deve renderizar todo o texto e a ação de conversão com JavaScript desabilitado. Verifique isso primeiro: se não o fizer, corrija isso antes de adicionar movimento, porque toda receita aqui assume que a página estática é o fallback.
  3. landing/tokens.css se presente. Use suas cores em shaders e fallbacks. Coloque tokens de movimento (durações, easings) em sua própria folha de estilo; deixe tokens.css como a direção de arte o escreveu.

Quando uma entrada estiver faltando:

  • Sem direction.md: pergunte ao usuário o que deve se mover e por quê. Se você não puder perguntar, o padrão é none (veja "Decidindo o que se move"); diga isso em seu resumo.
  • Sem página estática: pare e construa uma primeiro (landing-skills:landing-build), ou peça por ela. Movimento em camadas sobre uma página que só existe em JavaScript é como uma cena 3D com falha leva o título e a chamada para ação junto com ela.
  • A stack: leia package.json. React (Vite, Next) recebe as variantes React onde uma receita tem uma; todo o resto recebe a variante HTML, CSS e JavaScript puro. Um aplicativo React apenas no cliente (tudo renderizado em um #root vazio) falha na verificação sem JavaScript por construção: o texto deve estar no HTML primeiro, através de renderização no servidor, pré-renderização ou o padrão de ilha em references/webgl-3d.md.

Decidindo o que se move

Comece pela intenção em direction.md. Anote, para cada momento que ele nomeia: o elemento, o papel (entrada, feedback, vinculado ao scroll, ambiente ou 3D interativo), e o que o visitante aprende com ele. Se você não conseguir terminar essa frase, corte o momento.

none é uma resposta válida, muitas vezes a certa, e o padrão quando a intenção está faltando. Muitas páginas estão completas sem movimento além dos estados de feedback, especialmente quando fotografias ou texto as carregam; uma página com quase nenhum movimento não perde nada com isso.

Sob none esta é uma verificação curta, não um trabalho novo. landing-skills:landing-build já escreve estados de hover, foco, pressionar e desabilitado e um script de formulário com estados de envio, sucesso e erro. Abra a página em um navegador e confirme quatro coisas:

  1. A tabulação mostra um anel de foco visível em cada link, botão e campo.
  2. Os estados de hover e pressionar respondem em botões e links.
  3. Após o envio de um formulário, a mensagem de status aparece e recebe foco (references/interaction.md, "Feedback de envio de formulário", adiciona isso se estiver faltando).
  4. Nada se move por conta própria: sem reprodução automática, sem loop, sem revelação.

Opcionalmente, adicione temporização aos estados de hover e pressionar (references/interaction.md, "Estados de hover e pressionar"). Então pare. Se você não conseguiu abrir um navegador, diga isso e liste cada um dos quatro como "não executado"; não relate a página como verificada.

Quando a intenção nomeia momentos:

  • Um momento emblemático por página. A sequência do herói, a demonstração do produto, o objeto 3D. Todo o resto é mais silencioso do que ele.
  • Varie por papel, nunca por seção. Feedback é rápido (100 a 200 ms), entradas são mais lentas, movimento vinculado ao scroll segue o scroll. Aplicar o mesmo fade-up, easing e stagger a cada seção é o padrão mais reconhecível de página gerada, e não ensina nada ao visitante.
  • A maior parte do conteúdo não se move. Texto que o visitante está lendo nunca se move: sem parallax em parágrafos, sem revelação que esconde um bloco até que seja scrollado.
  • Demonstre, não decore. Movimento que mostra como o produto funciona (uma sequência de estados, uma vista explodida, um antes e depois) ganha seu custo. Movimento que apenas diz "esta página é animada" não ganha.

Leia references/foundations.md antes de escrever qualquer movimento. Ele contém as durações, easings e a lista de padrões que parecem gerados, cada um com o que fazer em vez disso.

Ajustando receitas à página

As receitas se anexam à página que existe; elas não reestilizam a página.

  • A página estática de landing-skills:landing-build deixa um substituto para cada momento que a direção nomeia: uma imagem de pôster ou placeholder rotulado em seu tamanho final. Marque esse elemento com data-moment="<nome>" (o nome da Intenção de movimento e 3D) se a construção não o fez, e anexe a receita a ele: adicione a classe de contêiner da receita a esse elemento, ou selecione-o pelo atributo.
  • A seção Código de cada receita abre com uma linha nomeando as classes que ela adiciona, como novas para esta skill, e as classes da construção que ela usa inalteradas. Adicione as novas classes; nunca redefina as próprias classes da construção (.hero, .hero__title, .button, .section, .split e o resto). Onde uma receita precisar de um layout que o elemento da construção não tem, envolva-o em um novo elemento próprio.
  • Use os tokens da construção (--color-*, --space-*, --radius-control) para qualquer cor ou tamanho que uma receita precisar, nunca um novo valor literal.

Escolhendo uma receita

Escolha o degrau mais baixo que produz o efeito: CSS, depois um script pequeno, depois GSAP ou Motion, depois WebGL. Cada receita tem Use quando, Evite quando, Código, Movimento reduzido e Custo; receitas 3D adicionam Fallback.

NecessidadeLeia
Durações, easings, molas, stagger, o que parece geradoreferences/foundations.md
Entrada do herói, headline de texto dividido, revelação com clip-path ou máscara, contadorreferences/entrances-text.md
Progresso do scroll, entrada vinculada ao scroll, storytelling fixo, seções horizontais ou fixas, scroll suavereferences/scroll.md
Camadas de profundidade no scroll, profundidade do ponteiro, parallax de imagem ou vídeo, parallax em Reactreferences/parallax.md
Temporização de hover e pressionar, feedback de envio de formulário, botão magnético, seguidor de cursor, inclinação, arrasto, dial graduado, transições de visualizaçãoreferences/interaction.md
Objeto 3D para girar, vista explodida no scroll, um contexto para dois estágios separados, modelo glTF, ilha React Three Fiberreferences/webgl-3d.md
O que importar e deixar de fora, arquivos de decodificador não utilizados na construção, criação de pôsteres, compressão de modelo e texturasreferences/webgl-assets.md
Caminho de câmera impulsionado por scroll, fundo de shader, partículas, distorção de imagem, WebGPUreferences/webgl-effects.md
Qual biblioteca, sua licença e tamanho, quando CSS é suficientereferences/libraries.md
Variantes de movimento reduzido, fallback de WebGL, pausa, orçamentos, protegendo o heróireferences/safety.md

Para qualquer trabalho 3D ou WebGL, leia references/safety.md primeiro (as receitas de cena importam seus helpers), depois "Antes de qualquer cena" em references/webgl-3d.md, então apenas a receita que você precisa.

Trilhos de segurança

Estes valem para todo efeito. references/safety.md tem o código.

  1. O herói pinta sem JavaScript. Título, lead e chamada para ação estão no HTML e visíveis na primeira pintura. Não comece o título ou imagem do herói com opacidade 0: um elemento com opacidade 0 não é candidato a Largest Contentful Paint até aparecer, então uma entrada longa atrasa o LCP. Carregue código 3D após o evento de load, com uma imagem de pôster em seu lugar até o primeiro quadro ser desenhado.
  2. Reduza, não delete. A própria declaração da direção sobre movimento reduzido vence; o que se segue é o padrão. Sob prefers-reduced-motion: reduce, remova parallax, animação de scroll escovado, loops de reprodução automática e grande deslocamento. Mantenha feedback e fades curtos. Uma cena 3D carrega apenas se for estática e controlada pelo usuário; pulá-la e mostrar os pôsteres é a escolha correta mais simples. Escreva a variante reduzida por efeito, e escute a preferência mudando enquanto a página está aberta. Uma regra global que zera a duração de toda animação é em si um indicador reconhecível.
  3. WebGL é opcional. Verifique um contexto antes de baixar qualquer código 3D. Em React, envolva o canvas em um limite de erro. Lide com a perda de contexto. O fallback é uma imagem real, nunca uma caixa vazia.
  4. Um canvas. Um segundo contexto WebGL dobra a memória e o trabalho da GPU. Coloque momentos 3D relacionados em um canvas fixo.
  5. Nada roda fora da tela. Canvases, vídeos e loops param quando fora de vista ou quando a aba está oculta.
  6. Scroll nunca re-renderiza um framework. Leia a posição do scroll no loop de quadros ou deixe o CSS dirigi-la. Nenhum setState por evento de scroll ou por quadro.
  7. Anime apenas transform e opacity. Nunca top, left, width, ou height.
  8. Auto-hospede cada ativo. Modelos, decodificadores, mapas de ambiente e fontes vêm de sua origem. Alguns helpers usam CDNs de terceiros por padrão; sobrescreva-os.
  9. Interação tem um caminho de teclado. Qualquer coisa que o ponteiro possa girar, arrastar ou alternar, o teclado também pode.

Definição de pronto

Verifique cada item em um navegador. Uma ferramenta de navegador é a melhor; sem uma, use o script de captura de landing-skills:landing-review para capturas de tela e diga quais verificações você não pôde fazer.

  • Cada momento nomeado em Intenção de movimento e 3D existe, e nada mais foi adicionado além de estados de feedback.
  • Com JavaScript desabilitado: todo o texto e a ação de conversão estão presentes.
  • Com movimento reduzido emulado: a página está completa e legível, nada reproduz automaticamente, sem parallax, sem escovado; estados de feedback ainda respondem.
  • Com WebGL desabilitado (flag do Chromium --disable-webgl): o pôster ou imagem estática aparece onde a cena estaria, e o texto do herói e a chamada para ação estão intactos.
  • O texto do herói está visível antes de qualquer código 3D ter carregado (limite a rede para verificar).
  • Nenhuma duas seções compartilham a mesma animação de entrada por padrão; o momento emblemático é o único grande.
  • Canvases param de desenhar quando scrollados para fora de vista (Painel de desempenho, ou um contador de chamadas de desenho como em references/safety.md).
  • O painel de rede não mostra nenhuma solicitação a um host de terceiros para ativos 3D.
  • Em uma construção de produção, three.js e outro código 3D estão em um chunk que não faz parte do bundle de entrada.
  • Teclado: toda rotação, arrasto e alternância funciona com teclas; o foco permanece visível.

O detector de indicadores detect-tells.mjs pertence a landing-skills:landing-review e é um auxílio opcional. Se estiver disponível, execute-o na página; ele sinaliza indicadores de nível de padrão, como atributos de revelação embutidos e a chave de desligamento de movimento reduzido. A verificação necessária é visual: role a página inteira uma vez com movimento ligado e uma vez com movimento reduzido, e confirme que cada coisa em movimento tem o papel que você anotou para ela.

Termine com um breve resumo para o usuário: cada momento adicionado e seu propósito, bibliotecas adicionadas com suas licenças, os ativos ainda necessários (por exemplo, um modelo real para substituir um substituto primitivo, uma imagem de pôster) e qualquer verificação que você não pôde executar.

Individual skills in this repo

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

Habilidades Relacionadas