Promptory Web Build
Três ferramentas, uma pilha, cada uma com um trabalho:
| Ferramenta | Função | Regra prática |
|---|---|---|
| Lenis | Motor de rolagem — rolagem suave e inercial sobre a rolagem nativa | Instalado uma vez, globalmente. Nunca por seção. |
| GSAP (+ ScrollTrigger) | Motor de animação — linhas do tempo personalizadas, animação acionada por rolagem, fixação | Qualquer coisa personalizada para o design deste site. |
| React Bits | Componentes animados prontos (texto, fundos, cursores, cartões, botões) | Recorra a ele primeiro quando um componente do catálogo já fizer o efeito. |
Eles compartilham um loop de animação: o ticker do GSAP aciona o Lenis, e o ScrollTrigger lê a rolagem do Lenis. Acertar essa conexão é a coisa mais importante nesta skill (§3).
Escopo: apenas web/DOM em tempo real. Para renderização de vídeo (Remotion, reels), esta skill não se aplica.
0. Regra de ouro — não redesenhe
Implemente o design e os efeitos solicitados pelo usuário. Não altere layout, cores, fontes, espaçamento ou texto por conta própria, e não adicione seções extras ou efeitos "bônus" que ninguém pediu. Se um efeito ou correção claramente melhorar algo, sugira em uma linha e aguarde uma resposta positiva. Movimento e verificações de qualidade devem servir ao design existente, não substituí-lo.
0.5 Questionário de coleta — PRIMEIRO passo em cada nova solicitação de site
Antes de escrever qualquer código para um novo site, execute o questionário de coleta em references/intake-questionnaire.md:
- Leia a solicitação e pule qualquer coisa já respondida.
- Faça as perguntas restantes em até 3 rodadas curtas (projeto → movimento → entrega). Use a ferramenta
AskUserQuestiondo Claude Code quando disponível (opções clicáveis + caixa de texto livre "Outro" automática); caso contrário, imprima cada rodada como um bloco de código com opções numeradas e uma linha "✎ أخرى" vazia em cada pergunta. - Mostre o Resumo do Projeto em um bloco de código e aguarde a autorização.
- Em seguida, construa, seguindo exatamente as respostas.
Se o usuário disser "ابدأ على طول" / "pule", use os padrões ⭐ e indique-os no Resumo. Para pequenas edições em um site existente, pule o questionário, a menos que a solicitação seja ambígua.
O resumo deve registrar: idioma e direção (Árabe/RTL, Inglês/LTR, ou ambos), o alvo de acessibilidade (padrão WCAG 2.2 AA), os formulários e seu backend, e a ferramenta de análise, se houver.
0.6 Referências visuais — Prompt Motion
https://prompt-motion.com/ é a biblioteca visual para direção de movimento (texto cinético, UI de produto, partículas, formas, gráficos…, cada um com o prompt por trás). Use-a apenas quando o usuário pedir inspiração, selecionar "precisa de uma proposta" / "movimento ousado" no questionário, ou compartilhar um link dela. Pegue a ideia de movimento, reconstrua-a com GSAP / Lenis / React Bits, mantenha o design do cliente. Fluxo de trabalho, mapa categoria→componente e o modelo de especificação de movimento: references/visual-references.md.
0.7 Nível de qualidade — verifique antes de mostrar qualquer coisa
Examine a construção em busca dos sinais de entrega genérica (acento índigo padrão, ícones de emoji, métricas inventadas, lorem ipsum, seções de modelo padrão). Corrija o que estiver em seu próprio código; sugira uma correção de uma linha para qualquer coisa no design do cliente. Lista completa: references/quality-bar.md.
0.8 Direção de design — cada site parece diferente
Quando o cliente não tem design próprio, escolha uma direção antes de escrever código. Leia references/design-styles.md e:
- Selecione três direções do guia de adequação para o setor e público do resumo.
- Pule qualquer direção usada nos últimos três sites neste chat ou projeto (Registro de Estilo).
- Escreva uma linha no Resumo do Projeto:
Direção: <nome> — <porquê>, com uma alternativa. - Construa com as escolhas de assinatura dessa direção e, em seguida, execute a verificação de Variedade: pelo menos quatro de seis eixos devem diferir do site anterior.
As direções são referências para estrutura e sensação. Nunca copie a marca, fotos, texto ou layout exato de uma referência. Se o cliente fornecer um design, siga-o e pule esta etapa (§0 regra de ouro).
0.9 Design visual distinto (quando o resumo deixa em aberto)
Fonte: anthropics/skills, skill frontend-design (Apache-2.0, veja seu LICENSE.txt). Aplica-se apenas onde o resumo deixa a direção visual em aberto. §0 vence: siga o design do cliente e as próprias palavras do resumo, inclusive quando o resumo pedir um dos looks listados abaixo.
- Identifique o assunto primeiro: produto, público, função principal. Se o resumo não disser, proponha um e confirme. Setor e materiais são de onde vêm as escolhas distintas.
- O herói abre com a coisa mais característica no mundo do assunto (título, imagem, demonstração ao vivo ou interação). Evite o padrão de um grande número, um pequeno rótulo e um acento gradiente, a menos que seja claramente a melhor opção.
- Tipo: uma família, ou duas que sejam claramente distintas. Defina uma escala de tipo clara. Em títulos, o tratamento de tipo faz parte do design.
- Comprimento da linha com menos de 80 caracteres. Texto do corpo com serifa precisa de um pouco mais de entrelinha do que sem serifa.
- Evite sinais tipográficos: uma palavra em itálico ou colorida em um título, rótulos em CAIXA ALTA e rótulos acima de títulos que não acrescentam nada.
- Marcadores numerados (01 / 02 / 03) apenas quando o conteúdo for realmente uma sequência.
- Movimento: um momento orquestrado (carregamento da página ou uma revelação). Sem fade-e-slide em cada seção, sem transição de hover em cada cartão. Movimento que responde a uma ação do usuário (abrir, expandir, confirmar) é bom.
- Planeje antes do código: 4–6 cores hexadecimais nomeadas, funções de tipo, um conceito de layout (ASCII wireframe permitido) e princípios. Revise o plano contra o resumo. Se uma parte parecer o padrão genérico para qualquer página semelhante, revise-a e diga o que mudou.
- Looks padrão a evitar, a menos que o resumo os solicite: fundo creme com acento terracota; quase-preto com acento verde-ácido ou vermelhão; jornal com regras finas e raio zero; cartões SaaS redondos idênticos com um raio e uma sombra cinza; sobrancelha EM CAIXA ALTA acima de cada título; strings de metadados com ponto médio ('A · B · C'); rótulos 'PALAVRA — fragmento'; #0B0B0B ou #111 representando preto; monoespaçado para rótulos pequenos; '→' em cada link.
- Gaste ousadia em um só lugar. Mantenha tudo ao redor quieto. Corte decoração que não serve ao resumo.
- Piso de qualidade: responsivo a dispositivos móveis, foco visível, movimento reduzido respeitado, contraste acessível.
- Cuidado com a especificidade dos seletores CSS, especialmente padding e margem entre seções, onde as regras se cancelam.
- Texto: palavras simples para o usuário final, voz ativa, capitalização de frase. Mantenha um verbo durante um fluxo ("Publicar" leva a "Publicado"). Erros dizem o que aconteceu e como corrigir, sem desculpas. Estados vazios convidam para a próxima ação.
1. Fluxo de decisão — qual ferramenta para qual solicitação
- Site em árabe, bilíngue ou RTL → leia
references/rtl-arabic.mdantes de escrever qualquer layout. A direção é estrutural; adaptá-la depois é caro. - Rolagem suave em qualquer lugar do site → Lenis (provedor global, §3). Faça isso uma vez na configuração do projeto quando existir qualquer animação de rolagem.
- Existe um componente React Bits que já faz o efeito? → verifique
references/react-bits-catalog.md→ instale-o (§4). Acertos típicos: texto dividido/borrado/embaralhado, texto de revelação de rolagem, fundos animados (aurora, partículas, grades, shaders), cursores personalizados, cartões magnéticos/inclinados, marquises, galerias, dock/menus, botões/contadores animados. - O efeito é específico para este design (sequência de introdução do herói, seção de storytelling fixa, seção de rolagem horizontal, revelações sincronizadas de vários elementos) → GSAP timeline / ScrollTrigger (§5, detalhes completos em
references/gsap.md). - O projeto NÃO é React (HTML puro/vanilla) → React Bits não está disponível; use apenas Lenis + GSAP (
assets/vanilla-setup.js). - Qualquer formulário, lista, reserva ou seção orientada a dados →
references/forms-and-states.md(rótulos, erros, cinco estados). - Escolhendo um serviço de terceiros (fontes, backend de formulários, análise, hospedagem, imagens) →
references/free-services.md, depois verifique os limites atuais. - Novo site sem design do cliente → escolha uma direção primeiro (§0.8,
references/design-styles.md).
2. Instalação
npm install gsap @gsap/react lenis
@gsap/react→ apenas para projetos React (forneceuseGSAP).lenis/reactelenis/snapvêm dentro delenis— sem pacotes extras.- Todos os plugins GSAP (ScrollTrigger, SplitText, Flip, ScrollSmoother, Draggable…) vêm dentro de
gsap. - Os componentes React Bits são adicionados individualmente via CLI (§4); alguns puxam suas próprias dependências (
motion,three,ogl,matter-js…) — a CLI os instala, mas verifique a coluna Deps no catálogo antes de escolher, para evitar inflar o bundle.
Nunca use o ScrollSmoother do GSAP junto com o Lenis — eles são dois motores de rolagem suave concorrentes. Lenis é o motor de rolagem nesta pilha.
3. Conectando Lenis + GSAP + ScrollTrigger (faça exatamente isso)
React / Next.js
Copie assets/SmoothScroll.jsx para o projeto (ex.: components/SmoothScroll.jsx) e envolva o app uma vez:
// app/layout.jsx (Next.js App Router)
import SmoothScroll from '@/components/SmoothScroll';
import ScrollToTopOnRoute from '@/components/ScrollToTopOnRoute';
export default function RootLayout({ children }) {
return (
<html lang="en">
<body>
<SmoothScroll>
<ScrollToTopOnRoute />
{children}
</SmoothScroll>
</body>
</html>
);
}
Para árabe, defina lang e dir a partir da localidade em <html> (veja references/rtl-arabic.md §1).
Para Vite/React, envolva <App /> em main.jsx da mesma forma e pule ScrollToTopOnRoute (ele usa next/navigation).
O que o provedor faz — e por que cada linha importa:
<ReactLenis root options={{ autoRaf: false }}>→ uma instância global em<html>;autoRaf: falseporque o GSAP irá acioná-lo.lenis.on('scroll', ScrollTrigger.update)→ ScrollTrigger recalcula em cada quadro de rolagem suave. Faltando isso = animações disparam tarde/em posições erradas.gsap.ticker.add(t => lenis.raf(t * 1000))→ um loop compartilhado (tempo do GSAP é em segundos, Lenis quer ms).gsap.ticker.lagSmoothing(0)→ sem gagueira ao recuperar após uma troca de aba.ScrollTrigger.refresh()após fontes e carregamento → posições do trigger correspondem ao layout final.
HTML/JS Vanilla
Use assets/vanilla-setup.js como módulo de entrada, importe lenis dele onde necessário.
4. React Bits — selecionando e instalando componentes
- Encontre o componente em
references/react-bits-catalog.md(agrupados: Animações de Texto, Animações, Componentes, Micro, Fundos — nome, o que faz, deps). - Escolha o sabor que corresponde ao projeto:
JSouTS, depoisCSSouTW(Tailwind). - Instale:
Para o atalhonpx shadcn@latest add @react-bits/SplitText-TS-TW@react-bits/, ocomponents.jsondo projeto deve conter:Sem{ "registries": { "@react-bits": "https://reactbits.dev/r/{name}.json" } }components.json/ não é um projeto shadcn? Use a URL direta:npx shadcn@latest add https://reactbits.dev/r/SplitText-TS-TW.json # ou npx jsrepo@latest add https://reactbits.dev/r/SplitText-TS-TW - Abra o arquivo instalado e leia suas propriedades antes de usá-lo — todo componente é configurável (cores, velocidade, atraso, easing, triggers). Defina as propriedades para corresponder aos tokens de design existentes do site (cores, fontes) em vez de deixar os padrões de demonstração.
- Se o usuário quiser o fluxo de trabalho do agente:
npx shadcn@latest mcp init --client claudeconecta o Claude Code ao registro via MCP.
Notas de integração:
- Os componentes React Bits que animam na rolagem (ScrollReveal, ScrollFloat, AnimatedContent, SplitText…) usam GSAP ScrollTrigger ou IntersectionObserver internamente → funcionam com Lenis automaticamente desde que §3 esteja em vigor.
- Os componentes são componentes do cliente (
'use client'). No Next.js, renderize-os dentro de componentes do cliente ou páginas que o permitam. - Fundos WebGL/shader (deps
three,ogl,vgpu) são pesados: no máximo um ou dois por página, carregue sob demanda os que estão abaixo da dobra (next/dynamiccomssr: falseouReact.lazy), e dê a eles um contêiner de tamanho fixo. Pause-os quando estiverem fora da tela ou quando a aba estiver oculta. - Não empilhe dois efeitos de cursor ou dois fundos na mesma janela de visualização.
- Verifique cada componente para um controle de pausa se ele fizer loop por mais de 5 segundos (veja
references/accessibility-motion.md§5). - Licença: React Bits é MIT + Commons Clause — livre para uso dentro de qualquer site de cliente (incluindo trabalho de cliente pago), mas os próprios componentes não devem ser revendidos ou redistribuídos como um pacote/modelo. Nunca cole a fonte do React Bits nesta skill ou em uma biblioteca compartilhada; sempre instale do registro.
5. Essenciais do GSAP (animação personalizada)
Sempre em React via useGSAP com um scope — nunca useEffect bruto:
'use client';
import { useRef } from 'react';
import gsap from 'gsap';
import { ScrollTrigger } from 'gsap/ScrollTrigger';
import { useGSAP } from '@gsap/react';
gsap.registerPlugin(ScrollTrigger, useGSAP);
export default function Story() {
const root = useRef(null);
useGSAP(() => {
const tl = gsap.timeline({
scrollTrigger: { trigger: root.current, start: 'top top', end: '+=150%', scrub: 1, pin: true },
});
tl.from('.line', { yPercent: 100, autoAlpha: 0, stagger: 0.15 })
.to('.image', { scale: 1.15 }, '<');
}, { scope: root });
return <section ref={root}>…</section>;
}
Padrões principais (detalhes + matchMedia responsivo, batching, FOUC, checklist em references/gsap.md):
- Linhas do tempo para qualquer coisa com >1 elemento;
ScrollTrigger.batch()para cartões repetidos. scrubpara movimento vinculado à rolagem (com Lenis,scrub: truejá é suave;scrub: 1adiciona atraso extra).pin: truefunciona com Lenis na rolagem nativa — sem necessidade de hackspinTypequando Lenis usaroot.- Seção de rolagem horizontal: fixe o wrapper, anime o
xda faixa para-(track.scrollWidth - innerWidth),scrub: true,invalidateOnRefresh: true. Em RTL, inverta a direção (vejareferences/rtl-arabic.md§6). - Envolva blocos decorativos em
gsap.matchMedia()para que usuários com movimento reduzido obtenham o substituto (references/accessibility-motion.md§3).
6. Formulários e estados
- Rótulos: flutuantes ou empilhados (veja
references/forms-and-states.md). - Cinco estados: vazio, preenchendo, erro (com mensagem), sucesso (confirmação), e desabilitado (processamento).
- Backend: escolha um serviço gratuito de
references/free-services.md, ou configure um endpoint de API.
7. Fontes
- Escolha de
references/free-services.md(Google Fonts, Fontsource, ou self-hosted). - Defina uma escala de tipo clara no CSS.
- No Next.js, otimize com
next/font. - Evite um tratamento de tipo que pareça genérico (veja §0.9).
8. Marcação de acessibilidade
- Meta descrição, landmarks (
<nav>,<main>,<footer>), heading hierarchy. - Alvo: WCAG 2.2 AA por padrão.
- Verificações de contraste em todo o design.
prefers-reduced-motionrespeitado (vejareferences/accessibility-motion.md).- Estados de foco visíveis.
- Suporte a navegação por teclado.
9. Análise
- Configure a ferramenta de análise escolhida (padrão: nenhuma, a menos que especificado no questionário).
- Use o
data-attrs para rastrear interações ou integre com React context.
10. Entrega
- Otimize imagens (WebP, AVIF, lazy loading).
- Verifique abertura em dispositivos móveis, tablets e desktop.
- Verifique desempenho com Lighthouse (alvo: >90 em todas as categorias).
- Forneça o build final em um formato que o usuário possa implantar (código-fonte exportado, URL de preview, etc.).
11. Referências
references/intake-questionnaire.md— perguntas de coletareferences/visual-references.md— catálogo de inspiração visual Prompt Motionreferences/quality-bar.md— verificações de qualidadereferences/design-styles.md— direções de designreferences/react-bits-catalog.md— catálogo de componentesreferences/gsap.md— padrões GSAP e checklistreferences/rtl-arabic.md— guia de layout RTLreferences/forms-and-states.md— guia de formuláriosreferences/free-services.md— serviços gratuitosreferences/accessibility-motion.md— guia de acessibilidade e movimentoassets/SmoothScroll.jsx— componente React Lenis + GSAPassets/vanilla-setup.js— configuração vanilla Lenis + GSAP