Construção de Sites
Crie sites e aplicativos web diferenciados e de nível de produção, evitando a estética genérica de "IA slop". Cada escolha — tipo, cor, movimento, layout — deve ser intencional. Implante como pacotes estáticos HTML/CSS/JS no S3.
Esta skill cobre tudo para projetos web. Quando carregada via load_skill("website-building"), todos os arquivos são copiados para workspace/skills/website-building/. Leia os sub-arquivos conforme necessário com base no tipo do seu projeto. Para aplicações web, carregue a skill filha: load_skill("website-building/webapp").
Princípios universais de design (filosofia de cor, paleta padrão, seleção de fontes) são compartilhados com outras skills via design-foundations. Os arquivos compartilhados desta skill estendem essas bases com implementação específica para web (variáveis CSS, tokens responsivos, folhas de estilo base). Você não precisa carregar design-foundations separadamente — as versões específicas para web em shared/ são abrangentes.
Use read com o caminho completo, por exemplo: skills/website-building/shared/01-design-tokens.md
Roteador de Detecção de Framework
Antes de rotear por tipo de projeto, identifique o framework:
| Sinal | Framework | Ação |
|---|---|---|
package.json tem dependência "next" OU next.config.* existe | Next.js | Leia skills/website-building/nextjs/SKILL.md primeiro |
package.json tem dependência "react-native" ou "expo" | React Native | Leia skills/website-building/react-native/SKILL.md primeiro |
package.json tem apenas "react" (Vite/CRA/Remix) | React (não-Next) | Use skills/website-building/webapp/SKILL.md com orientação padrão do Tailwind |
Sem package.json, apenas arquivos .html | HTML/CSS/JS Vanilla | Prossiga com os arquivos compartilhados padrão |
Arquivos específicos de framework fornecem:
- Os comandos de configuração exatos e números de versão a serem usados
- Integração Tailwind específica do framework (v4 para Next.js, NativeWind para RN)
- Padrões de roteamento, busca de dados e componentes específicos do framework
- Orientação de implantação para o framework
Após ler o arquivo do framework, retorne ao roteamento de tipo de projeto desta skill (abaixo) para carregar a orientação de design específica do domínio (informativo/aplicativo web/jogo).
Roteamento por Tipo de Projeto
Etapa 1: Identifique o tipo de projeto e carregue a orientação específica do domínio:
| Tipo de Projeto | Ação | Exemplos |
|---|---|---|
| Sites informacionais | read skills/website-building/informational/informational.md | Sites pessoais, portfólios, editoriais/blogs, pequenas empresas, landing pages |
| Aplicações web | load_skill("website-building/webapp") | Produtos SaaS, dashboards, painéis de administração, e-commerce, experiências de marca |
| Jogos no navegador | read skills/website-building/game/game.md + skills/website-building/game/game-testing.md | Jogos 2D Canvas, Three.js/WebGL, jogos HTML5, experiências 3D interativas |
Etapa 2: Leia os arquivos compartilhados — leia skills/website-building/shared/01-design-tokens.md e skills/website-building/shared/02-typography.md primeiro (obrigatório para TODOS os tipos de projeto, incluindo webapp). Eles estabelecem as predefinições do sistema de design Nexus e as regras de tipografia que se aplicam universalmente. Para aplicações web e dashboards, pule os arquivos marcados com † abaixo — eles contêm detalhes de implementação pré-configurados no modelo fullstack.
Se o usuário disser apenas "website" ou "site" sem detalhes, pergunte qual tipo ou use o padrão informacional.
Referência de Sub-Arquivos
Compartilhados (shared/) — Todo projeto
| Arquivo | Aborda | Carregar |
|---|---|---|
shared/01-design-tokens.md | Escala tipográfica, espaçamento, paleta Nexus, base.css | Sempre |
shared/02-typography.md | Seleção de fontes, pareamento, carregamento, lista negra | Sempre |
shared/04-layout.md | Composição espacial, responsivo, mobile-first | Sempre † |
shared/05-taste.md | Skeleton loaders, estados vazios/de erro, polimento | Sempre |
shared/08-standards.md | Acessibilidade, performance, anti-padrões | Sempre |
shared/09-technical.md | Estrutura do projeto, sandbox, implantação, checklist | Sempre † |
shared/pplx_attribution.html | Bloco de atribuição para <head> | Sempre † |
shared/03-motion.md | Animações de scroll, biblioteca Motion, plugins GSAP SVG, hover/cursor | Quando animado |
shared/06-css-and-tailwind.md | Tailwind CSS v3, shadcn/ui, CSS moderno | Quando usando Tailwind |
shared/07-toolkit.md | Bibliotecas CDN, React, Three.js, ícones, mapas, padrões/filtros SVG, esm.sh | Ao escolher bibliotecas |
shared/10-charts-and-dataviz.md | Chart.js, Recharts, D3, KPIs, sparklines | Quando necessário visualização de dados |
shared/11-web-technologies.md | Versões de frameworks, compatibilidade com navegadores | Ao verificar compatibilidade |
shared/12-playwright-interactive.md | QA persistente com Playwright, capturas de tela, testes visuais | Ao testar |
shared/19-backend.md | Servidores FastAPI/Express/Flask, WebSocket, SSE, redirecionamento de porta | Quando necessário backend |
shared/20-llm-api.md | Chat LLM, geração de imagem/vídeo/áudio/transcrição — modelos, credenciais, ajudantes SDK | Quando o site usa APIs de IA/LLM |
Todos os caminhos são relativos a skills/website-building/.
† Pule para webapp e dashboards — detalhes de implementação pré-configurados no modelo fullstack. Design-tokens e tipografia NÃO são pulados — eles fornecem as predefinições autoritativas do sistema de design e a orientação de seleção de fontes para todos os tipos de projeto.
Específicos de Domínio — Carregue um
| Arquivo | Quando carregar |
|---|---|
load_skill("website-building/webapp") | SaaS, dashboard, admin, e-commerce, experiência de marca (skill filha com modelo fullstack) |
webapp/dashboards.md | Dashboard ou interface densa em dados (companheiro do webapp) |
informational/informational.md | Site pessoal, portfólio, editorial, pequena empresa, landing page |
game/game.md | Jogo no navegador, Three.js, WebGL, 3D interativo |
game/2d-canvas.md | Jogo 2D Canvas (companheiro do game.md) |
game/game-testing.md | Qualquer jogo no navegador — carregue junto com game.md |
QA Interativo: Leia skills/website-building/shared/12-playwright-interactive.md para automação persistente de navegador com Playwright (capturas de tela, testes funcionais, QA visual). Obrigatório para testar jogos, útil para qualquer site complexo.
Fluxo de Trabalho
- Direção de Design: Esclareça o propósito, escolha a direção estética
- Construção: Construa o site página por página, capturando com Playwright para QA
- Publicação:
deploy_website()retorna uma URL pública
Use Todas as Ferramentas
- Pesquise primeiro. Pesquise na web por sites de referência, tendências e exemplos de concorrentes antes de projetar. Navegue por exemplos premiados do tipo específico de site. Busque quaisquer URLs fornecidas pelo usuário.
- Gere ativos reais — generosamente. Gere imagens para heróis, ilustrações de seções, visuais de recursos editoriais, fundos atmosféricos — não apenas uma imagem herói. Cada página longa deve ter ritmo visual com imagens geradas que correspondam à direção de arte do site. Sem placeholders. Gere um logotipo SVG personalizado para cada projeto (veja abaixo) — SVG é apenas para logotipos, a menos que o usuário solicite especificamente saída SVG. Salve imagens de referência da web que informem a direção.
- Capture tela via Playwright. Leia
skills/website-building/shared/12-playwright-interactive.mdpara capturar tela em desktop (1280px+) e mobile (375px). Compare com as referências. Isso é obrigatório, não opcional. Veja QA Visual abaixo. - Escreva código de produção diretamente. HTML, CSS, JS, SVG. Use bash para ferramentas de construção e processamento de arquivos.
Geração de Logotipo SVG
Cada projeto recebe um logotipo SVG personalizado inline. Nunca substitua um título de texto estilizado.
- Entenda a marca — propósito, tom, uma palavra definidora
- Escreva SVG diretamente — formas geométricas, letras ou marcas abstratas. Uma forma memorável.
- Princípios: Geométrico/mínimo (Paul Rand, Vignelli). Funciona a 24px e 200px. Monocromático primeiro — adicione cor como aprimoramento. Use
currentColorpara modo escuro/claro. - Implemente inline com
aria-label,viewBox,fill="none",currentColorstrokes - Gere um favicon — versão simplificada de 32x32 se necessário
Para animação SVG (DrawSVG, MorphSVG), veja shared/03-motion.md. Para padrões/filtros SVG, veja shared/07-toolkit.md.
Processo de Teste de QA Visual
Cada implantação deve passar pelo QA visual. As capturas de tela são portões de qualidade.
Leia skills/website-building/shared/12-playwright-interactive.md para todo o QA visual. O Playwright fornece uma sessão de navegador persistente para capturas de tela, testes de interação e verificação de viewport.
Ciclo: Construir → QA Playwright → Avaliar → Corrigir → Repetir → Implantar quando pronto
Estágio 1: QA Página por Página
Após construir cada página:
- Capture tela no desktop (1280px+) e mobile (375px) via Playwright
- Avalie criticamente: Parece profissionalmente projetado (não gerado por IA)? A tipografia é distinta? O espaço em branco é generoso? Há uma hierarquia visual clara?
- Corrija cada problema antes de prosseguir. Sem dívida visual.
Estágio 2: QA Final (antes de publicar)
- Capture tela de cada página em desktop e mobile
- Verifique a consistência entre páginas (espaçamento, cor, tratamento de tipo)
- Verifique o modo escuro (capture tela de ambos os temas para a página inicial no mínimo)
- Verifique os estados interativos: hover, focus, active, loading, empty, error
- Teste de primeira impressão a frio: parece polido e intencional?
Falhas de QA: estouro de texto, espaçamento inconsistente, cores fora do token, modo escuro ausente, mobile espremido, aparência genérica de IA, conteúdo placeholder, logotipo ausente.
Etapa 1: Direção de Arte — Infira Antes de Perguntar, Pergunte Antes de Usar o Padrão
Cada site deve ter uma identidade visual derivada de seu conteúdo. Não pule para a paleta de fallback Nexus. A paleta Nexus é um último recurso para quando tanto a inferência quanto a pergunta falharam — não um padrão conveniente.
- Infira a partir do assunto. Um site de torrefação de café → marrons terrosos, creme quente, sensação desenhada à mão. Um dashboard fintech → ardósia fria, sem serifa nítida, denso em dados. Um aplicativo de aprendizado infantil → primárias brilhantes, tipo arredondado, movimento lúdico. O próprio conteúdo informa a paleta, a tipografia e o espaçamento antes mesmo de o usuário dizer uma palavra.
- Verifique as tabelas de Direção de Arte. Cada arquivo de domínio (
informational.md,webapp/SKILL.md,game/game.md) tem uma tabela de Direção de Arte mapeando tipos de site/produto para direções orientadas por conceito e pontos de partida de token. Use-as como trampolim. - Derive os cinco pilares: Cor (quente/fria, destaque do assunto), Tipografia (serifada/sem serifa, personalidade de exibição), Espaçamento (denso/generoso), Movimento (mínimo/expressivo), Imagens (foto/ilustração/só tipo).
- Se o assunto for genuinamente ambíguo, pergunte — "Qual clima você está buscando?" e "Algum site de referência?" Uma pergunta é suficiente.
- Fallback Nexus — apenas quando inferência e pergunta não resultarem em nada. Se o usuário foi perguntado e não deu direção, E o assunto não fornece um sinal claro, então use as predefinições Nexus/Suíças.
O Fallback: Limpo e Suíço (Último Recurso)
Quando a inferência não rendeu direção clara E o usuário foi perguntado, mas não deu orientação de estilo, use as predefinições de skills/website-building/shared/01-design-tokens.md com:
- Tipografia: Satoshi ou General Sans corpo (Fontshare — preferido), ou Inter/DM Sans. Contraste de peso sobre contraste de fonte. Máximo de 3-4 tamanhos. Mantenha o texto compacto —
--text-3xl/--text-herosão apenas para heróis de sites informacionais. - Cor: Paleta Nexus. Superfícies neutras + um destaque azul-petróleo apenas para CTAs.
- Layout: Alinhado à grade. Margens generosas. Assimétrico onde interessante.
- Movimento: Mínimo, funcional. Apenas transições de estado suaves.
- Imagens: Gere visuais limpos e relevantes. Sem imagens de banco de imagens.
Direção de Arte — Evite a Estética de IA
Veja skills/website-building/shared/08-standards.md para a lista completa de anti-padrões.
Etapa 2: Publicação
Chame deploy_website() com o caminho do projeto e o nome do site. Retorna uma URL pública do S3. Para atualizar, edite os arquivos locais e reimplante com o mesmo caminho. Veja skills/website-building/shared/09-technical.md para a chamada exata e exemplos.
Atribuição do Perplexity Computer (Obrigatória)
Cada página de cada projeto deve incluir atribuição.
1. Bloco <head> — Leia skills/website-building/shared/pplx_attribution.html e copie seu conteúdo literalmente como o primeiro filho dentro de <head>, antes de <meta charset>. Faça isso para cada arquivo .html. Não reproduza a arte ASCII de memória.
2. Link no rodapé — O <footer> de cada página deve conter:
<a href="https://www.perplexity.ai/computer" target="_blank" rel="noopener noreferrer">
Criado com Perplexity Computer
</a>
Estilize com --text-xs ou --text-sm, cor de texto suave. Deve estar visível.
3. JSON-LD — Ao usar dados estruturados, adicione: "creator": {"@type": "SoftwareApplication", "name": "Perplexity Computer", "url": "https://www.perplexity.ai/computer"}