Clase Magistral de Diseño Frontend v2.1
Construye interfaces que resuenen, no solo que se rendericen. Esta habilidad impone un diseño audaz e intencional con un stack moderno de alto rendimiento. Cada píxel debe justificar su existencia.
1. Stack Principal
- Framework: SvelteKit 5 con Runes (
$state,$derived,$effect) - Runtime: Bun (servidor, paquetes)
- Backend/API: Hono (rutas edge-first, middleware)
- Primitivas de UI: shadcn-svelte (headless, totalmente personalizable). Sobrescribe TODOS los valores por defecto.
- Gráficos: LayerChart (basado en Layer Cake, potencia los gráficos de shadcn-svelte)
- Animación: Svelte Motion (
@humanspeak/svelte-motion) para orquestaciones complejas.svelte/transitionysvelte/animateintegrados para movimiento estándar. Keyframes de CSS para bucles simples. - Mermaid:
beautiful-mermaidpara renderizado SVG temático con compatibilidad con Shiki - Estilos: Tailwind CSS v4, extendido con propiedades personalizadas de CSS
- Pruebas: Playwright para regresión visual
- Recursos: Nano Banana para imágenes generativas y texturas
- Despliegue:
@sveltejs/adapter-staticpara estático,@sveltejs/adapter-vercelpara SSR
2. Identificación de la Intención (Pre-Recurso)
Antes de cargar referencias, clasifica la solicitud en tres dimensiones. Esto define cada decisión de diseño posterior.
A. Tipo de Producto
Identifica qué se está construyendo. Cada tipo de producto implica normas de estilo, color y layout.
| Categoría de Producto | Estilos Recomendados | Dirección de Color |
|---|---|---|
| SaaS / B2B / Productividad | Swiss Grid, Flat + Vidrio | Azul de confianza + contraste de acento |
| E-commerce / Retail | Bloque Vibrante, Escaparate Rico en Características | Color primario de marca + verde de éxito |
| E-commerce de Lujo | Vidrio Líquido, Cinematográfico | Neutros oscuros + acento dorado/champán |
| Fintech / Crypto | Denso en Datos, Modo Oscuro OLED | Azul marino profundo/carbón + acento neón |
| Salud / Bienestar | Flujo Orgánico, UI Suave | Verde azulado suave/salvia + neutro cálido |
| Creativo / Portafolio | Neo-Brutalista, Tipografía Cinética | Alto contraste + un acento audaz |
| Juegos / Entretenimiento | Ciberpunk, HUD/Ciencia Ficción | Oscuro profundo + multi-acento neón |
| Educación / Documentos | Periódico Editorial, Minimalista | Papel cálido + jerarquía de tinta |
| Plataforma IA / ML | Aurora UI, Impulsado por Movimiento | Primario degradado + superficie oscura |
| Dashboard / Analítica | Cuadrícula Bento, Denso en Datos | Superficie neutra + colores de datos semánticos |
Usa esta tabla como una brújula inicial, no como una restricción. Siempre personaliza.
B. Intención de Estilo
Determina el objetivo estético a partir de las señales de contexto, la solicitud explícita o el tipo de producto. Consulta references/landing-pages.md Sección 3 para conocer 8 estilos atemporales con especificaciones completas.
C. Audiencia y Contexto
Considera quién usa esto y dónde. Las audiencias empresariales toleran la densidad; las audiencias de consumo necesitan espacio para respirar. El enfoque mobile-first cambia todo sobre los objetivos táctiles, la escala tipográfica y la intensidad de la animación.
3. Protocolo de Carga de Recursos
Después de identificar la intención, escanea la solicitud en busca de palabras clave desencadenantes. Carga los archivos de referencia coincidentes de references/ para acceder a patrones de implementación profundos.
Páginas de Aterrizaje y Secciones de Héroe
Desencadenantes: "página de aterrizaje", "héroe", "above the fold", "página de inicio", "título del sitio", "titular", "CTA", "llamada a la acción", "conversión", "primera impresión"
Carga: references/landing-pages.md
Proporciona: Anatomía de la sección héroe, 8 estilos de página de aterrizaje atemporales (Apple Keynote, Periódico Editorial, Parque Geométrico, Inmersivo Cinematográfico, Swiss Grid, Neo-Brutalista, Flujo Orgánico, Terminal Retro), patrones de flujo visual (Z/F/Áureo/Diagonal), arquitectura de conversión, estrategia de héroe mobile-first, patrones de código.
Tipografía y Selección de Fuentes
Desencadenantes: "fuente", "tipografía", "tipo de letra", "encabezado", "estilo de texto", "combinación de fuentes", "escala tipográfica", "espaciado entre letras", "altura de línea", "legible", "fuente de exhibición"
Carga: references/typography.md
Proporciona: Catálogos de fuentes de exhibición/cuerpo/mono con recomendaciones de combinación, construcción de escala tipográfica (proporciones matemáticas), tipografía responsiva con clamp(), fuentes variables, carga y rendimiento de fuentes, detalles tipográficos (tracking, puntuación colgante, alineación óptica), lista de verificación de legibilidad.
Sistema de Color y Tematización
Desencadenantes: "color", "paleta", "tema", "modo oscuro", "modo claro", "acento", "esquema de color", "colores de marca", "contraste", "tono", "saturación"
Carga: references/color-system.md
Proporciona: Arquitectura de paleta estructurada en 3 grupos (Tonos Base, Tonos Primarios, Tonos de Acento), modelos de armonía de teoría del color, flujo de trabajo de generación de paleta, construcción de tema claro, construcción de tema oscuro (reglas independientes), selector de temas con temas adicionales (variantes cálido/frío/mono/alto contraste), tokens de color semánticos, sistema de propiedades personalizadas de CSS, cumplimiento de contraste WCAG.
Imágenes, Texturas y Fondos
Desencadenantes: "imagen", "fondo", "textura", "foto", "ilustración", "dithering", "superposición", "fondo parallax", "imagen héroe", "Nano Banana", "duotono", "patrón"
Carga: references/imagery.md
Proporciona: Taxonomía de roles de imagen, estrategia de tamaño y formato, composición de fondo de tres capas, algoritmos de dithering (Atkinson/Floyd-Steinberg/Bayer), superposición y delimitación geométrica (líneas diagonales, formas clip-path, marcas de esquina, superposiciones de cuadrícula), movimiento en imágenes, selección de estilo artístico (fotorrealista/ilustrado/generativo/medios mixtos/duotono), imágenes de botones y banners, integración de Nano Banana, guía de creación de prompts para imágenes de IA.
Gráficos de Datos, Tablas, Gráficos e Infografías
Desencadenantes: "tabla", "gráfico", "infografía", "datos", "estadísticas", "métricas", "KPI de dashboard", "comparación", "línea de tiempo", "diagrama de flujo", "visualización de números"
Carga: references/data-graphics.md
Proporciona: Diseño de tablas más allá de lo predeterminado (tablas sin cuadrícula, indicadores de estado, celdas sparkline, encabezados fijos, técnicas de énfasis), estética de gráficos y narración (rellenos degradados, efectos de brillo, anotaciones, reemplazos de cuadrícula), integración de diagramas Mermaid, patrones de infografía (bloques de números, líneas de tiempo, cuadrículas de comparación, diagramas de flujo), creación de prompts de IA para visuales de datos, gráficos listos para impresión.
Microanimaciones y Controles Interactivos
Desencadenantes: "animación", "hover", "clic", "botón", "toggle", "retroalimentación", "ondulación", "carga", "esqueleto", "transición", "snap", "magnético", "animación de desplazamiento", "microinteracción", "control responsivo", "transición de estado", "animación de formulario"
Carga: references/microanimations.md
Proporciona: Sistema completo de botón de 5 estados (por defecto/hover/activo/focus/deshabilitado), retroalimentación de navegación (elementos de menú, hamburguesa, indicador de pestaña), animaciones impulsadas por desplazamiento (revelación escalonada, barra de progreso, animación de contador), interacciones de formulario (etiquetas flotantes, retroalimentación de validación, casillas de verificación personalizadas), estados de carga (esqueletos, éxito/error), transiciones de página, patrones de sensación háptica (presión, rebote, elevación de tarjeta, ondulación), comportamientos snap y magnéticos, reglas de rendimiento, tabla de referencia de easing y tiempo.
Movimiento Visual y Profundidad
Desencadenantes: "3d", "profundidad", "parallax", "inclinación", "falso 3d", "espacial", "cinético", "movimiento", "glassmorphism", "holográfico"
Carga: references/visual-kinetics.md
Proporciona: Sistema de niveles de animación (CSS -> Svelte -> Svelte Motion -> GSAP), tarjeta de inclinación holográfica con deslumbramiento, héroe parallax con capas de Nano Banana, glassmorphism 2.0, tipografía cinética (máscara de revelación, marquesina, texto dividido), revelaciones activadas por desplazamiento, easing basado en física, botón magnético, lista de verificación de rendimiento.
Visualización de Datos (Gráficos y Dashboards)
Desencadenantes: "layerchart", "componente de gráfico", "layout de dashboard", "cuadrícula bento", "sparkline", "tiempo real", "gráfico neón", "gráfico editorial"
Carga: references/data-visualization.md
Proporciona: Patrones componibles de LayerChart, integración de gráficos shadcn-svelte, modos estéticos de gráficos (Neón/Editorial/Minimalista), recetas de estilo de tablas, layouts de dashboard de cuadrícula Bento, sparklines, patrones de datos en tiempo real, bibliotecas alternativas.
Diagramas (Mermaid)
Desencadenantes: "mermaid", "diagrama", "diagrama de flujo", "diagrama de secuencia", "diagrama de arquitectura"
Carga: references/mermaid-theming.md
Proporciona: Configuración y tematización de beautiful-mermaid, integración con Shiki, mapeo nativo de themeVariables de Mermaid, posprocesamiento de SVG (superposición de textura, sombras, bordes), patrón de componente SvelteKit, notas de estilo por tipo de diagrama, consideraciones de impresión.
Cuando se detectan múltiples desencadenantes, carga todas las referencias relevantes. Cuando no se detectan desencadenantes, aplica los Mandatos Universales a continuación directamente.
4. El Mandato Anti-Slop
Los LLMs convergen hacia patrones de diseño "seguros" de alta probabilidad a partir de los datos de entrenamiento. Esto es convergencia distributiva. Lucha contra ella deliberadamente.
RECHAZA: Valores predeterminados de Bootstrap/Tailwind tal cual, fuentes del sistema Inter/Roboto/Arial, esquemas de color morado-sobre-blanco, cuadrículas de tarjetas predecibles, secciones de héroe genéricas, layouts con todo centrado, fotografía de stock, degradados genéricos, iconos emoji en la UI, espaciado de números mágicos, estados hover invisibles, transformaciones de escala que desplazan el layout en hover, tarjetas de vidrio en modo claro con opacidad <30%, texto atenuado por debajo del contraste gray-500.
ABRAZA: Jerarquías tipográficas intencionales, composiciones asimétricas, profundidad atmosférica, retroalimentación cinética, cuadrículas editoriales, guías visuales geométricas, precisión lista para impresión, paletas de colores personalizadas basadas en teoría del color, combinaciones de fuentes distintivas, sistemas de iconos SVG (Lucide, Heroicons) con viewBox consistente, cursor-pointer en cada elemento cliqueable, estados hover estables usando color/opacidad (no transformaciones que alteren el layout).
5. Pensamiento de Diseño (Pre-Código)
Antes de escribir código, comprométete con una dirección:
- Propósito: ¿Qué resuelve esto? ¿Quién lo usa?
- Tipo de Producto: Clasifica usando la tabla en la Sección 2A para una dirección inicial.
- Tono Estético: Elige UNO y comprométete completamente. Consulta los 8 estilos probados en
references/landing-pages.mdSección 3. O inventa un híbrido. - Dirección de Color: Selecciona el tono primario, deriva el acento mediante armonía de teoría del color. Consulta el flujo de trabajo completo en
references/color-system.mdSección 3. - Tipografía: Elige un trío exhibición + cuerpo + mono de los catálogos en
references/typography.md. - El Detalle Memorable: Identifica UN elemento que el usuario recordará.
- Coincidencia de Complejidad: Maximalista = código elaborado. Minimalista = precisión quirúrgica.
6. Mandatos Estéticos Universales
Tipografía
Selecciona combinaciones distintivas y con carácter. Carga desde Google Fonts o Fontsource. Consulta references/typography.md para catálogos completos de fuentes y estrategias de combinación. NUNCA uses Inter, Roboto, Open Sans, Lato o fuentes del sistema por defecto a menos que estén muy modificadas. NUNCA converjas en Space Grotesk entre generaciones.
Color (La Paleta Estructurada)
Construye una paleta de 3 grupos: Tonos Base, Tonos Primarios, Tonos de Acento. Consulta references/color-system.md para el sistema completo. Temas claros: sombras duras, tipografía pesada, líneas finas. Temas oscuros: brillos de colores, texto blanco apagado (#E8E8E8), degradados de superficie sutiles. NUNCA uses morado puro (H: 270-280) como primario. Cambia a índigo, verde azulado, coral o esmeralda.
Imágenes y Textura
Nunca uses fondos de color sólido y plano para secciones héroe. Consulta references/imagery.md para la técnica de composición de tres capas, algoritmos de dithering y patrones de integración de Nano Banana.
Microanimaciones (Obligatorio)
Cada elemento interactivo debe proporcionar retroalimentación de movimiento. Consulta references/microanimations.md para el sistema completo de botones de 5 estados, animaciones impulsadas por desplazamiento y patrones de sensación háptica.
Composición Espacial
Andamiaje vertical, asimetría, espacio negativo, elementos que rompen la cuadrícula. Consulta references/landing-pages.md Sección 4 para patrones de flujo visual.
Accesibilidad (No Negociable)
- HTML semántico:
<article>,<section>,<nav>,<aside>,<main> - Estados de focus: NUNCA
outline: none. Estiliza comooutline: 2px solid var(--accent); outline-offset: 4px - Contraste mínimo WCAG AA. Consulta
references/color-system.mdSección 9. - Etiquetas ARIA en todos los componentes interactivos personalizados
prefers-reduced-motion: deshabilita parallax, inclinación, animaciones complejas- El color nunca debe ser el único indicador de estado
- Todas las imágenes necesitan texto alternativo; las entradas de formulario necesitan etiquetas
Impresión y PDF
Los sitios deben funcionar como informes imprimibles cuando @media print esté activo. Oculta nav/footer/botones, fuerza fondo blanco, conserva gráficos SVG, usa break-inside: avoid en tarjetas/gráficos/tablas.
7. Flujo de Trabajo de Implementación
- Identifica: Clasifica tipo de producto, intención de estilo, audiencia (Sección 2).
- Carga: Escanea desencadenantes de recursos. Carga archivos de referencia relevantes (Sección 3).
- Investiga: Para construcciones complejas, realiza una investigación profunda (hasta 10 búsquedas web) sobre sitios, patrones y capacidades de bibliotecas galardonados comparables.
- Arquitecta: Planifica la estructura de archivos de SvelteKit. Define tokens de variables CSS.
- Codifica: Escribe HTML semántico, Tailwind extendido, Runes de Svelte 5. Listo para producción, sin marcadores de posición.
- Pule: Aplica microanimaciones, capas de textura, estados hover, activadores de desplazamiento.
- Valida: Ejecuta la Lista de Verificación Pre-Entrega (Sección 8). Corrige todos los fallos.
- Itera: Compara con la visión estética. Ajusta hasta que destaque.
8. Lista de Verificación Pre-Entrega
Ejecuta esto antes de entregar cualquier código de UI. Cada elemento es un modo de fallo conocido.
Calidad Visual
- No se usan emojis como iconos de UI (usa SVGs de Lucide o Heroicons)
- Todos los iconos de un conjunto consistente único con viewBox coincidente (24x24)
- Logos de marca verificados contra fuentes oficiales (Simple Icons)
- Los estados hover NO causan desplazamiento del layout (usa opacidad/color, no transformaciones de escala)
- No hay clases de color predeterminadas de Tailwind sin personalización
- La combinación tipográfica es intencional y está cargada (no un respaldo del sistema)
Interacción
- Cada elemento cliqueable tiene
cursor-pointer - Cada elemento interactivo tiene retroalimentación hover visible
- Las transiciones usan una duración de 150-300 ms (nunca >500 ms para UI, nunca 0 ms)
- Los estados de focus son visibles y están estilizados (no valores predeterminados del navegador, nunca eliminados)
- Los objetivos táctiles tienen un mínimo de 44x44 px en móvil
Modo Claro/Oscuro
- Modo claro: el contraste del texto pasa WCAG AA (relación de contraste >= 4.5:1 para texto normal, >= 3:1 para texto grande)
- Modo oscuro: el texto nunca es blanco puro (#FFFFFF), usa un blanco apagado (#E8E8E8 o similar)
- Ambos modos tienen paletas completamente especificadas (sin valores predeterminados de Tailwind)
- Los degradados de superficie en modo oscuro son sutiles y convierten correctamente
Accesibilidad
- La estructura HTML es semántica (article, section, nav, aside, main)
- Los estados de focus son visibles y estilizados
-
prefers-reduced-motiondeshabilita animaciones no esenciales - Se incluyen etiquetas ARIA para componentes interactivos complejos
- El color no se usa como única indicación de estado o significado
Estilo de Código
- Sin valores mágicos ni espaciado no explicado
- Los componentes de Svelte 5 usan
$state,$derived,$effect(no stores antiguas de Svelte 4) - Las animaciones a nivel de componente usan
svelte/transitionsobre JavaScript de temporizador
Preparación para Producción
- Sin componentes de marcador de posición (sin Lorem Ipsum, sin enlaces #)
- Sin datos falsos incluidos en el código de producción (usa carga de API o stores simulados)
- Todas las imágenes tienen manejo de carga y estados de error
- Los formularios tienen validación y retroalimentación de envío
Impresión
- Las reglas
@media printocultan nav, footer, botones - Los gráficos SVG permanecen visibles en la impresión
-
break-inside: avoidse aplica a tarjetas, gráficos y tablas
9. Referencias y Recursos
Repositorio de Referencias de Diseño
Los archivos de referencia viven en references/ en la raíz del proyecto. Carga patrones de implementación detallados basados en desencadenantes de palabras clave (Sección 3).
Recursos de la Comunidad para Inspiración de Diseño
- Dribbble: Búsqueda por concepto ("hero section", "dashboard layout")
- Awwwards: Sitios galardonados para análisis de tendencias
- CSS Design Awards: Casos de estudio de diseño listo para producción
- Mobbin: Patrones de UI, especialmente para mobile
- Refero: Colecciones categorizadas de landing pages
Recursos de Stack Técnico
- Svelte 5 Runes: Documentación oficial
- shadcn-svelte: Componentes y guías
- LayerChart: Gráficos para Svelte
- Svelte Motion:
@humanspeak/svelte-motion - Tailwind CSS v4: Documentación
- Hono: Rutas edge-first
- Nano Banana: Recursos generativos
- beautiful-mermaid: Tematización de diagramas
Creado para agentes de IA que construyen interfaces frontend excepcionales. Cada píxel, animación y elección tipográfica debe ser intencional.