O que Construtor de Sites faz?
Fluxo de Trabalho
1. Avaliar o Projeto
Determine o tipo de projeto e selecione a stack:
| Sinal | Stack | Implantação |
|---|---|---|
| Site de marketing, portfólio, páginas simples | HTML/CSS/JS vanilla ou Astro | Netlify |
| Aplicação dinâmica com autenticação, API, banco de dados | Next.js + Tailwind | Vercel |
| Páginas de loja Shopify (produto, coleção, homepage) | Templates Liquid + JSON | API do Shopify |
| Blog/documentação com muito conteúdo | Astro + MDX | Netlify |
Para critérios detalhados de seleção de stack, consulte references/stack_guide.md.
2. Estabelecer o Sistema de Design
Antes de escrever qualquer componente, defina os tokens de design:
Cores: primary, secondary, accent, neutral (50-900), success, error
Tipografia: fonte do título, fonte do corpo, escala (xs até 4xl)
Espaçamento: unidade base de 4px (4, 8, 12, 16, 24, 32, 48, 64)
Raio: sm (4px), md (8px), lg (12px), full
Sombras: sm, md, lg
Aplique os ativos da marca (logotipo, cores, fontes) de forma consistente em todos os componentes. Para padrões de construção de paletas, consulte references/design_tokens.md. Para inspiração de design de bem-estar/e-commerce (estilo Serene Herbs, Magic Mind), consulte references/design_inspiration.md.
3. Construir Componentes
Sites estáticos: Construa seção por seção, mobile-first. Cada seção é autocontida com seus próprios estilos.
Aplicações React/Next.js: Arquitetura orientada a componentes. Construa átomos → moléculas → organismos → páginas.
Temas Shopify: Construa como seções Liquid com blocos {% schema %} para editabilidade no Personalizador de Temas. Para padrões específicos do Shopify, pegadinhas e implantação, consulte references/shopify_2_0.md.
4. Implantar
Netlify (sites estáticos):
npx netlify-cli deploy --prod --dir=./dist
Shopify (seções Liquid + templates JSON): Use scripts empacotados para enviar via Admin API:
scripts/deploy_shopify_section.py— envia arquivos de seção.liquidscripts/deploy_shopify_template.py— envia template JSON e atribui produtos
Vercel (Next.js):
npx vercel --prod
Para detalhes de implantação e padrões de segurança, consulte references/deployment.md.
Referência Rápida do Shopify
Shopify é a stack mais propensa a erros. Principais pegadinhas:
- Tipos de bloco — Use os nomes reais dos tipos de bloco do tema (ex.:
titlenão@app/title) - Campos Richtext — Sem atributos
stylenas tags HTML; apenas HTML semântico - Esquemas de cores — Nomeados
scheme-1ascheme-5(nãobackground-1) - image-with-text — O conteúdo usa blocos (heading, text, button), NÃO configurações em nível de seção
- Segurança do template_suffix — Alterar o suffix afeta TODOS os temas; sempre envie um modelo de fallback para o tema ativo primeiro
- Limitação de taxa — Adicione
time.sleep(0.5)entre chamadas de API
Referência completa do Shopify com exemplos: references/shopify_2_0.md