O que Página de destino de produto faz?
Uma receita, destilada do site de marketing da Kesami, para uma única página estática que parece projetada, em vez de modelada, e resiste a escrutínio: contraste verificado, amigável ao teclado, honesta sobre o produto, rápida.
O resultado é uma página Next.js feita de seções renderizadas no servidor. A interatividade é limitada a algumas pequenas "ilhas" de cliente que alternam atributos DOM ou variáveis CSS em vez de re-renderizar. Não há biblioteca de UI, nem Tailwind, nem biblioteca de animação.
O que está incluído
| Caminho | Uso |
|---|---|
assets/scaffold/ | Um site completo e construível (verificado com typecheck e next build). Copie-o, não redigite. Conteúdo de placeholder, sistema de design funcional. |
assets/optional-sections/ | Três seções extras do site original (uma comparação antes/depois, uma árvore de arquivos com limites de dados, um mural de scripts) como exemplos trabalhados. Não conectadas. |
scripts/accent.mjs | Deriva os tons de destaque seguros para contraste para qualquer cor de marca. |
scripts/capture.cjs | Tira screenshots do site em execução em larguras de desktop e celular, percorrendo a rolagem, através de uma janela Electron fora da tela. |
references/design-system.md | Tokens, temas, tipografia, espaçamento, a lógica de contraste de destaque e por que cada um existe. Leia antes de alterar cores ou tipografia. |
references/section-patterns.md | Cada seção: para que serve, como é construída, o truque que a torna leve. Leia antes de adicionar ou remodelar uma seção. |
references/motion-and-a11y.md | Orçamento de movimento, movimento reduzido, sem JS, alvos de toque, armadilhas de hidratação. Leia antes de adicionar qualquer animação ou código de cliente. |
references/copy-and-facts.md | Voz, a regra de um cenário e como manter as afirmações verdadeiras. Leia antes de escrever cópia. |
references/verify.md | A lista de verificação e comandos para executar antes de considerar o site pronto. |
Fluxo de trabalho
1. Reunir entradas (olhe antes de perguntar)
Leia o README do produto, o manifesto do pacote, o código de preços/planos e o fluxo de trabalho de lançamento primeiro; a maioria das respostas está lá. Pergunte ao usuário apenas o que não pode ser encontrado. Você precisa:
- Nome do produto, promessa em uma frase, para quem é e a única coisa que o diferencia.
- Plataformas, faixas de preço e limites de planos, cada um com o arquivo que é a fonte da verdade.
- Uma cor de marca (qualquer hex) ou permissão para escolher uma. Escolha uma única cor e use-a como a única cor de destaque.
- Se existe uma fonte de exibição licenciada. Se não, o substituto de licença aberta do scaffold (Instrument Serif) é suficiente.
- Quais seções se aplicam. Conjunto padrão: Hero, ticker, Como funciona, Pergunte/demo, Preços, FAQ, Fechamento, Rodapé. Adicione Privacidade, Idiomas ou uma comparação antes/depois quando o produto tiver uma história que precise de uma.
- Onde o site fica. Padrão: uma pasta
website/no repositório do produto, um pacote independente fora de qualquer workspaces npm para que as instalações e o arquivo de lock do aplicativo não sejam tocados.
2. Scaffold
cp -R ~/.claude/skills/product-landing-site/assets/scaffold <target>/website
cd <target>/website && npm install && npx tsc --noEmit && npx next build
Execute a build uma vez antes de editar para saber que a linha de base está verde. Mona Sans é buscada do Google Fonts no momento da build e depois servida a partir do próprio site, então a primeira build precisa de rede.
3. Marca
node ~/.claude/skills/product-landing-site/scripts/accent.mjs <brand-hex>imprime--accent,--accent-display, o tom achatado e se o rótulo do botão deve ser tinta ou branco. Coloque-os emapp/globals.css(--brand,--brand-hover,--brand-tint,--accent,--accent-display) e substitua os#ff5e00/#e25300codificados emapp/icon.svgeapp/opengraph-image.tsx.- Redesenhe a marca em
components/Logo.tsxeLogo.module.css(o placeholder são quatro barras de voz). Mantenha-a como divs ou SVG inline, nunca um raster. - Defina
SITEemlib/site.ts(nome, slug, wordmark, título, lead, CTA, nota). Oslugtambém define o namespace da preferência de moeda no localStorage.
Por que o script em vez de olho: uma cor de marca saturada quase nunca atinge 4.5:1 como texto em uma página clara, então a página precisa da cor da marca para preenchimentos e um tom mais escuro para texto. Adivinhar o tom irmão é como os sites quebram o contraste.
4. Fatos antes da cópia
Preencha lib/site.ts (planos, plataforma, links, FAQ) a partir dos próprios arquivos de origem do produto e registre a fonte de cada fato no
README.md do site sob "De onde vêm os fatos". Mantenha a proveniência no README em vez de em comentários de código, para que o scaffold
permaneça livre de comentários. Se o repositório de destino ou o usuário solicitar comentários explicativos, siga isso em vez disso.
Em seguida, leia references/copy-and-facts.md e escreva a cópia.
5. Um cenário, compartilhado em todos os lugares
lib/demo.ts contém um único cenário fictício do qual o mock do hero, a história do produto e o demo interativo extraem.
Substitua-o por um cenário do próprio domínio do produto (tickets de suporte, um pull request, um calendário, uma planilha, uma
reunião). Como cada seção lê os mesmos dados, a página nunca se contradiz, e o demo pode mostrar honestamente o
contrato real do produto (por exemplo, cada reivindicação cita sua fonte).
6. Seções
Comece pelas nove seções do scaffold. Para cada seção, decida: qual única ideia ela carrega e qual é a única imagem que prova
em vez de descrever? Leia references/section-patterns.md. Siga a gramática da seção:
- chip de rótulo (
.label, comdata-scramble), depois umh2.display.h2com as últimas palavras em.em, depois um.leadopcional - seções alternam
data-theme="light"/"paper"para que cada uma comece em uma borda de cor, não em uma linha regrada - um botão preenchido por viewport; todo o resto é um link de texto com o sublinhado da marca
- mocks de produto usam
data-theme="dark"e tamanhos px, porque eles representam screenshots do aplicativo (escuro). Se o aplicativo é claro, torne os mocks claros.
7. Verificar
Siga references/verify.md. Em resumo: typecheck, build, screenshots em 1440 e 390 com scripts/capture.cjs, leia-os,
percorra a rolagem para confirmar que as revelações disparam, verifique movimento reduzido e sem JS, reexecute accent.mjs --check para qualquer nova cor de
texto. Relate qualquer coisa não verificada em vez de sugerir que foi.
Inegociáveis e por quê
- Componentes de servidor por padrão; ilhas de cliente apenas para comportamento. A página é HTML estático que funciona sem JS e custa
quase nada para hidratar. As ilhas escrevem atributos
data-*ou variáveis CSS e deixam o CSS fazer o trabalho visual. - Apenas tokens semânticos nos componentes. Os componentes leem
--bg,--fg,--accent; odata-themede uma seção os troca. É assim que um componente pode ficar em Canvas, branco, o tom ou um mock escuro sem edições. - Tamanhos de texto em rem, mocks em px. O tamanho do texto do navegador do leitor deve se aplicar à página; mocks são representantes de screenshots.
- Texto escurecido recua pela cor, nunca pela opacidade. A opacidade silenciosamente reduz o contraste abaixo de 4.5:1.
- A cópia nunca ultrapassa o produto. Sem plataformas não lançadas, sem endereço de suporte que não existe, sem "nada sai do seu dispositivo" se o áudio é transmitido para um servidor. Uma página de marketing que promete demais é um bug.
- Nenhum controle de pausa de animação está embutido. Movimento em loop para para
prefers-reduced-motion. A revisão de design da Kesami recusou deliberadamente um controle de pausa, então o scaffold não tem nenhum; ofereça um se o usuário quiser.
Estendendo além do scaffold
Invente novas seções com as mesmas primitivas em vez de importar uma biblioteca: propriedades personalizadas CSS para estado, um
IntersectionObserver por comportamento, details/summary para divulgação, position: sticky para narrativa com rolagem, @property para
animar variáveis. Se você se pegar recorrendo ao framer-motion ou a um pacote de carrossel, releia
references/motion-and-a11y.md primeiro; a resposta é quase sempre uma variável CSS e um atributo.