Constructor de Sitios Web
Flujo de Trabajo
1. Evaluar el Proyecto
Determina el tipo de proyecto y selecciona el stack:
| Señal | Stack | Despliegue |
|---|---|---|
| Sitio de marketing, portafolio, páginas simples | HTML/CSS/JS vanilla o Astro | Netlify |
| Aplicación dinámica con autenticación, API, base de datos | Next.js + Tailwind | Vercel |
| Páginas de tienda Shopify (producto, colección, inicio) | Plantillas Liquid + JSON | API de Shopify |
| Blog/documentación con mucho contenido | Astro + MDX | Netlify |
Para criterios detallados de selección de stack, consulta references/stack_guide.md.
2. Establecer el Sistema de Diseño
Antes de escribir cualquier componente, define los tokens de diseño:
Colores: primario, secundario, acento, neutral (50-900), éxito, error
Tipografía: fuente de encabezados, fuente del cuerpo, escala (xs hasta 4xl)
Espaciado: unidad base de 4px (4, 8, 12, 16, 24, 32, 48, 64)
Radio: sm (4px), md (8px), lg (12px), completo
Sombras: sm, md, lg
Aplica los activos de marca (logotipo, colores, fuentes) de forma consistente en todos los componentes. Para patrones de construcción de paletas, consulta references/design_tokens.md. Para inspiración de diseño de bienestar/comercio electrónico (estilo Serene Herbs, Magic Mind), consulta references/design_inspiration.md.
3. Construir Componentes
Sitios estáticos: Construye sección por sección, mobile-first. Cada sección es autocontenida con sus propios estilos.
Aplicaciones React/Next.js: Arquitectura basada en componentes primero. Construye átomos → moléculas → organismos → páginas.
Temas Shopify: Construye como secciones Liquid con bloques {% schema %} para editabilidad en el Personalizador de Temas. Para patrones específicos de Shopify, problemas comunes y despliegue, consulta references/shopify_2_0.md.
4. Desplegar
Netlify (sitios estáticos):
npx netlify-cli deploy --prod --dir=./dist
Shopify (secciones Liquid + plantillas JSON): Usa los scripts empaquetados para enviar a través de la API de Administración:
scripts/deploy_shopify_section.py— envía archivos de sección.liquidscripts/deploy_shopify_template.py— envía plantilla JSON + asigna productos
Vercel (Next.js):
npx vercel --prod
Para detalles de despliegue y patrones de seguridad, consulta references/deployment.md.
Referencia Rápida de Shopify
Shopify es el stack más propenso a errores. Problemas clave:
- Tipos de bloque — Usa los nombres reales de tipos de bloque del tema (p. ej.,
titleno@app/title) - Campos de texto enriquecido — No hay atributos
styleen las etiquetas HTML; solo HTML semántico - Esquemas de color — Nombrados
scheme-1ascheme-5(nobackground-1) - image-with-text — El contenido utiliza bloques (encabezado, texto, botón), NO configuraciones a nivel de sección
- Seguridad de template_suffix — Cambiar el sufijo afecta a TODOS los temas; siempre envía primero una plantilla de respaldo al tema activo
- Límite de tasa — Añade
time.sleep(0.5)entre las llamadas a la API
Referencia completa de Shopify con ejemplos: references/shopify_2_0.md