Hex a OKLCH: Guía de migración de Design Tokens a Tailwind CSS v4

Guía paso a paso para actualizar temas Hex y HSL de Tailwind v3 a variables CSS @theme oklch() con brillo perceptual estable y Display P3.

Lectura de 6 min · Actualizado 2026-11-22

Resumen

CriterioHex / HSL legado (Tailwind v3)OKLCH @theme (Tailwind v4)
SintaxisCadenas Hex en tailwind.config.jsCSS @theme --color-* : oklch(...)
Uniformidad perceptualNo — el amarillo brilla más que el azulSí — el eje L sigue el brillo percibido
Gama Display P3Recortado a sRGB de 8 bitsListo para Display P3 y Rec.2020
Tintes dinámicosRequiere funciones de preprocesadorCSS nativo oklch(from var(--c) ...)

Por qué Tailwind v4 cambió las paletas base de Hex a OKLCH

Las cadenas Hex ocultan la luminosidad real: dos tonos nivel 500 en azul y amarillo tienen contrastes completamente distintos sin auditoría manual.

OKLCH coloca la Luminosidad perceptual (L) en primer lugar, Croma (C) en segundo y Tono (H) en tercero, manteniendo el peso visual uniforme.

  • Escaleras 50–950 coherentes: texto oscuro pasa con seguridad sobre 50–400 y blanco sobre 600–950.
  • Colores relativos nativos de CSS sin plugins Sass ni PostCSS.

Convertir tema Tailwind v3 a v4 OKLCH

Mapear theme.extend.colors de tailwind.config.js a @theme

Pega tus colores Hex de Tailwind v3 o variables :root en el conversor de Colr para transformar cada paso por sRGB lineal D65 hacia oklch() exacto.

Reemplaza las paletas estáticas Hex de tailwind.

Mapear theme.extend.colors de tailwind.config.js a @theme
CSS
@import "tailwindcss";

@theme {
  --color-brand-50: oklch(97.2% 0.014 261.2);
  --color-brand-500: oklch(54.6% 0.215 262.9);
  --color-brand-700: oklch(42.4% 0.178 263.5);
  --color-brand-950: oklch(23.1% 0.086 264.1);
}

Verificar contraste WCAG 2.2 y APCA tras migrar

Audita siempre tus rampas 50–950 antes de pasar a producción,

especialmente en botones intermedios 500–600 con texto blanco.

  • Comprueba pasos 500 y 600 para asegurar relación 4.5:1 en botones.
  • Revisa la vista previa de respaldo sRGB para acentos wide-gamut.

Crear escala OKLCH 50–950 accesible

Herramientas usadas en esta guía

Formatos relacionados

Preguntas frecuentes

¿Rompen los colores oklch() navegadores más antiguos?

Chrome, Safari, Firefox y Edge modernos desde 2023 soportan oklch() nativamente; puedes mantener respaldos Hex opcionales si das soporte heredado.

¿Se ven idénticos Hex y OKLCH en monitores sRGB estándar?

Sí, un Hex convertido a oklch() representa exactamente el mismo color hasta que aumentes deliberadamente C hacia Display P3.

Más guías de color