Criação de Sites
Crie sites distintos e de nível profissional que evitem a estética genérica de 'IA sem critério'. Cada escolha — tipo, cor, movimento, layout — deve ser intencional. Implante como pacotes estáticos HTML/CSS/JS no S3.
Este skill cobre tudo para projetos web. Quando carregado via load_skill("website-building"), todos os arquivos são copiados para workspace/. Leia os sub-arquivos conforme necessário, baseado no tipo de projeto. Para aplicações web, carregue o sub-skill: load_skill("website-building/webapp").
Princípios universais de design (filosofia de cor, paleta padrão, seleção de fontes) são compartilhados com outros skills via design-foundations. Os arquivos compartilhados deste skill estendem essas fundações com implementações específicas 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, ex.: shared/01-design-tokens.md
Roteamento por Tipo de Projeto
Passo 1: Identifique o tipo de projeto e carregue as diretrizes específicas do domínio:
| Tipo de Projeto | Ação | Exemplos |
|---|---|---|
| Sites informativos | read informational/informational.md | Sites pessoais, portfólios, editoriais/blogs, pequenos negócios, landing pages |
| Aplicações web | load_skill("website-building/webapp") | Produtos SaaS, dashboards, painéis administrativos, e-commerce, experiências de marca |
| Jogos de navegador | read game/game.md + game/game-testing.md | Jogos Canvas 2D, Three.js/WebGL, jogos HTML5, experiências 3D interativas |
Passo 2: Leia os arquivos compartilhados — leia shared/01-design-tokens.md e shared/02-typography.md primeiro (obrigatório para TODOS os tipos de projeto, incluindo webapp). Eles estabelecem os padrõ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 template fullstack.
Se o usuário disser apenas "site" ou "página" sem detalhes, pergunte qual tipo ou use o padrão informativo.
Referência de Sub-Arquivos
Compartilhados (shared/) — Todo projeto
| Arquivo | Aborda | Carregar |
|---|---|---|
shared/01-design-tokens.md | Escala de tipo, espaçamento, paleta Nexus, base.css | Sempre |
shared/02-typography.md | Seleção de fontes, combinação, 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/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 usar 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 precisar de 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 navegador Playwright, capturas de tela, testes visuais | Ao testar |
shared/19-backend.md | Servidores FastAPI/Express/Flask, WebSocket, SSE, encaminhamento de porta | Quando precisar de backend |
shared/20-llm-api.md | Chat LLM, geração de imagem/vídeo/áudio, transcrição — modelos, credenciais, helpers SDK | Quando o site usa APIs de IA/LLM |
Todos os caminhos são relativos a ``.
† Pule para webapp e dashboards — detalhes de implementação pré-configurados no template fullstack. Design-tokens e tipografia NÃO são pulados — eles fornecem os padrões autoritativos do sistema de design e orientação de seleção de fontes para todos os tipos de projeto.
Específicos do Domínio — Carregue um
| Arquivo | Quando carregar |
|---|---|
load_skill("website-building/webapp") | SaaS, dashboard, admin, e-commerce, experiência de marca (sub-skill com template fullstack) |
skills/website-building/webapp/dashboards.md | Dashboard ou interface densa em dados (complementar ao webapp) |
informational/informational.md | Site pessoal, portfólio, editorial, pequeno negócio, landing |
game/game.md | Jogo de navegador, Three.js, WebGL, 3D interativo |
game/2d-canvas.md | Jogo Canvas 2D (complementar ao game.md) |
game/game-testing.md | Qualquer jogo de navegador — carregue junto com game.md |
QA Interativo: Leia shared/12-playwright-interactive.md para automação persistente de navegador com Playwright (capturas de tela, testes funcionais, QA visual). Necessário para testes de jogos, útil para qualquer site complexo.
Fluxo de Trabalho
- Direção de Design: Esclareça o propósito, escolha a direção estética
- Controle de Versão: Execute
git initno diretório do projeto após o scaffolding. Faça commit após cada marco importante com uma mensagem curta. - Construção: Construa o site página por página, tirando capturas de tela via Playwright para QA visual
- Publicação: Faça commit de todas as alterações, então
deploy_website()retorna a URL pública
Use Toda Ferramenta
- 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 assets reais — generosamente. Gere imagens para heróis, ilustrações de seção, visuais de recursos editoriais, fundos atmosféricos — não apenas uma imagem de herói. Toda 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 é para logotipos apenas, 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 (apenas sites complexos). Para sites com várias páginas, aplicativos web, dashboards e jogos, leia
skills/website-building/shared/12-playwright-interactive.mdpara capturar tela em desktop (1280px+) e mobile (375px). Pule Playwright para sites estáticos simples de página única — veja QA Visual abaixo. - Escreva código de produção diretamente. HTML, CSS, JS, SVG. Use bash para ferramentas de build e processamento de arquivos.
Geração de Logotipo SVG
Cada projeto recebe um logotipo SVG personalizado inline. Nunca substitua por 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/minimalista (Paul Rand, Vignelli). Funciona em 24px e 200px. Monocromático primeiro — adicione cor como aprimoramento. Use
currentColorpara modo escuro/claro. - Implemente inline com
aria-label,viewBox,fill="none", traçoscurrentColor - 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
Quando usar Playwright QA
Pule Playwright para sites simples. Sites estáticos de página única NÃO precisam de capturas de tela do Playwright. Revise o código diretamente e implante. O QA do Playwright adiciona tempo significativo e não vale a pena para conteúdo estático simples.
Use Playwright para sites complexos. Sites com várias páginas, aplicações web, dashboards, jogos e qualquer site com recursos interativos (formulários, carrinhos, filtros, gráficos, arrastar e soltar) DEVEM usar QA do Playwright. Leia skills/website-building/shared/12-playwright-interactive.md para automação persistente de navegador.
Processo de QA Playwright (apenas sites complexos)
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 qualquer problema antes de prosseguir. Sem dívida visual.
Estágio 2: QA Final (antes de publicar)
- Capture tela de cada página no 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 estados interativos: hover, focus, active, loading, empty, error
- Teste de primeira impressão: parece polido e intencional?
Falhas de QA: texto transbordando, espaçamento inconsistente, cores fora do token, modo escuro ausente, mobile espremido, aparência genérica de IA, conteúdo de placeholder, logotipo ausente.
Passo 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é → tons terrosos de marrom, creme quente, sensação feita à mão. Um dashboard fintech → ardósia fria, sans-serif nítido, denso em dados. Um aplicativo de aprendizado infantil → primários brilhantes, tipo arredondado, movimento lúdico. O conteúdo em si diz a paleta, tipografia e espaçamento antes que o usuário diga 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 baseadas em conceito e pontos de partida de tokens. Use-as como trampolim. - Derive os cinco pilares: Cor (quente/fria, acento do assunto), Tipografia (serif/sans, personalidade de exibição), Espaçamento (denso/generoso), Movimento (mínimo/expressivo), Imagens (foto/ilustração/somente texto).
- 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 a inferência E a pergunta não produzirem nada. Se o usuário foi perguntado e não deu direção, E o assunto não dá nenhum sinal claro, então recorra aos padrões Nexus/Suíços.
O Fallback: Limpo e Suíço (Último Recurso)
Quando a inferência não produziu direção clara E o usuário foi perguntado, mas não deu orientação de estilo, use os padrões de shared/01-design-tokens.md com:
- Tipografia: Satoshi ou General Sans para corpo (Fontshare — preferido), ou Inter/DM Sans. Contraste de peso em vez de contraste de fonte. Máximo 3-4 tamanhos. Mantenha o texto compacto —
--text-3xl/--text-herosão apenas para heróis de sites informativos. - Cor: Paleta Nexus. Superfícies neutras + um acento verde-azulado 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 fotos de stock.
Direção de Arte — Evite a Estética de IA
Veja shared/08-standards.md para a lista completa de anti-padrões.
Passo 2: Publicação
Chame deploy_website() com o caminho do projeto e nome do site. Retorna uma URL pública do S3. Para atualizar, edite os arquivos locais e re-implemente com o mesmo caminho. Veja shared/09-technical.md para a chamada exata e exemplos.