Tokens de diseño
Un conjunto pequeño de valores con nombre, usado en todas partes, es lo que hace que un sitio luzca diseñado en lugar de ensamblado. Define los tokens antes que los componentes; cambiar una marca más adelante se reduce a editar un bloque.
Qué preguntar
Un color de marca (o una palabra de estado de ánimo), base clara u oscura, y el tono (corporativo, divertido, editorial, técnico). Todo lo demás se puede derivar.
Color
Trabaja con roles, no con nombres de color, de modo que un cambio de marca no requiera renombrar.
| Token | Rol | Regla general |
|---|---|---|
--bg | Fondo de página | Blanco roto o casi negro, nunca #fff o #000 puros |
--surface | Tarjetas, entradas | 2 a 4% de diferencia en luminosidad respecto a --bg |
--text | Texto del cuerpo | Al menos 7:1 sobre --bg |
--muted | Texto secundario | Al menos 4.5:1 sobre --bg |
--border | Líneas finas | 10 a 15% del color del texto mezclado con el fondo |
--accent | Botones, destacados | El color de marca |
--accent-ink | Enlaces y texto de acento sobre --bg | La marca, oscurecida (o aclarada en modo oscuro) hasta que pase 4.5:1 |
--on-accent | Texto sobre acento | El blanco o el oscuro que pase 4.5:1 |
Pautas:
- Tiñe los neutros ligeramente hacia el tono del acento (2 a 6% de saturación). Los grises puros junto a un acento cálido se ven desconectados.
- Usa el acento en aproximadamente el 10% de la superficie. Si todo está acentuado, nada lo está.
- Rara vez se necesita un segundo acento. Agrega uno solo para un significado distinto como éxito o oferta.
- Para modo oscuro, no inviertas. Aumenta la luminosidad de la superficie a medida que aumenta la elevación y reduce ligeramente la saturación del acento para que no brille.
Si el CLI webcraft está disponible, genera un conjunto inicial en lugar de derivar valores manualmente. Aplica todas las reglas anteriores, resuelve la luminosidad hasta que cada par pase, y construye el tema oscuro por separado:
webcraft tokens "#e4572e" --tone editorial -o tokens.css # también: --base dark, --radius pill
webcraft tokens "#e4572e" --format theme-json # theme.json de WordPress con los mismos valores
Dentro de un cliente MCP, lo mismo es la herramienta generate_tokens. Trata la salida como un primer borrador: ajusta a ojo, luego vuelve a verificar.
Verifica cada par de texto y fondo antes de finalizar:
webcraft contrast "#1b1b1f" "#f6f4ef"
webcraft contrast --tokens tokens.css
python scripts/contrast.py --tokens tokens.css # fallback sin instalación, solo valores hex
La primera forma imprime la relación y los niveles WCAG para un par. La segunda lee un archivo CSS y verifica los pares de roles estándar en cada bloque de tema (:root, [data-theme], prefers-color-scheme), resolviendo var() y leyendo hex, rgb(), hsl(), oklch() y color-mix(). Los pares que fallan son el defecto de accesibilidad más común en sitios nuevos, y son invisibles para personas con buena visión en un buen monitor, por lo que esto es un script y no una decisión subjetiva.
Tipografía
- Máximo dos familias: una para títulos, otra para cuerpo. Una sola familia en dos pesos suele ser mejor.
- Combínalas por contraste de estructura (serif display con sans cuerpo, o condensado display con cuerpo regular), no dos sans-serif similares.
- Tamaño de cuerpo de 16 a 18px, altura de línea de 1.5 a 1.7, longitud de línea de 60 a 75 caracteres.
- Tipografía display: altura de línea de 0.95 a 1.1, tracking negativo que crece con el tamaño.
- Escala fluida con
clamp()para que no haya saltos entre puntos de interrupción:
:root {
--step--1: clamp(0.83rem, 0.8rem + 0.15vw, 0.9rem);
--step-0: clamp(1rem, 0.95rem + 0.25vw, 1.125rem);
--step-1: clamp(1.25rem, 1.1rem + 0.6vw, 1.6rem);
--step-2: clamp(1.6rem, 1.3rem + 1.3vw, 2.4rem);
--step-3: clamp(2rem, 1.5rem + 2.6vw, 3.6rem);
--step-4: clamp(2.5rem, 1.6rem + 4.6vw, 5.5rem);
--step-5: clamp(3rem, 1.5rem + 7vw, 7.5rem);
}
- Carga fuentes con
font-display: swap, precarga los uno o dos archivos usados above the fold, y subconjunta si auto-alojas.
Espaciado, radio, sombra
:root {
--space-1: 0.25rem; --space-2: 0.5rem; --space-3: 0.75rem; --space-4: 1rem;
--space-6: 1.5rem; --space-8: 2rem; --space-12: 3rem; --space-16: 4rem;
--section: clamp(4rem, 3rem + 6vw, 9rem); /* padding vertical entre secciones */
--gutter: clamp(1rem, 0.5rem + 3vw, 3rem); /* padding lateral de la página */
--container: 76rem;
--radius-sm: 8px; --radius: 16px; --radius-lg: 28px; --radius-pill: 999px;
--shadow: 0 1px 2px rgb(0 0 0 / .04), 0 8px 24px rgb(0 0 0 / .06);
}
- Elige una personalidad de esquina (afilada, suave o píldora) y mantenla. Los radios mixtos son la forma más rápida de parecer inconsistente.
- El espaciado entre secciones debe ser claramente mayor que el espaciado dentro de ellas; ese espacio es lo que le dice al ojo dónde termina una sección.
Salida
Entrega un tokens.css con un bloque :root, un bloque opcional [data-theme="dark"], y una tabla breve de qué token se usa dónde. Luego indica los resultados de contraste para el texto del cuerpo, el texto atenuado y el texto de los botones.
Rebranding de un sitio existente
Primero mapea los valores codificados existentes a roles (busca en el CSS códigos hex y cuenta las ocurrencias), reemplázalos con tokens, verifica que nada haya cambiado visualmente, luego intercambia los valores de los tokens. Hacer ambas cosas a la vez hace que las regresiones sean imposibles de rastrear.