Color
La paleta de NachUI en modo claro y oscuro, la convención de foreground y el contraste medido de cada par de texto.
El color en NachUI es casi todo neutro. El modo claro se arma con grises cálidos tipo papel, con un tinte muy leve (tono entre 75 y 85, croma muy baja), para que el blanco nunca se vea clínico. El modo oscuro usa grises puros, con croma cero, escalonados para que las superficies se apilen con claridad sobre un fondo casi negro. Los únicos tonos de verdad son los cuatro colores de feedback y el resaltado de sintaxis, que los reutiliza.
Todos los valores de abajo se leen directo de los archivos del tema
nachui, light.tokens.json y dark.tokens.json, así que esta página no puede desfasarse de lo que usan los componentes.Paleta
Los tokens están agrupados igual que en los archivos de tokens. Cada fila muestra la variable CSS, la utilidad de Tailwind que normalmente vas a usar (todo token de color también tiene sus formas
bg-, text-, border- y ring-) y el valor en los dos modos.SuperficieClaroOscuro
- --backgroundbg-backgroundoklch(100% 0 0)#ffffffoklch(13% 0 0)#070707
- --foregroundtext-foregroundoklch(19% 0 0)#141414oklch(97% 0 0)#f5f5f5
- --cardbg-cardoklch(100% 0 0)#ffffffoklch(22.5% 0 0)#1c1c1c
- --card-foregroundtext-card-foregroundoklch(19% 0 0)#141414oklch(97% 0 0)#f5f5f5
- --popoverbg-popoveroklch(100% 0 0)#ffffffoklch(25% 0 0)#222222
- --popover-foregroundtext-popover-foregroundoklch(19% 0 0)#141414oklch(97% 0 0)#f5f5f5
- --surface-mutedbg-surface-mutedoklch(96.2% 0 0)#f2f2f2oklch(18.5% 0 0)#131313
- --inversebg-inverseoklch(19% 0 0)#141414oklch(97% 0 0)#f5f5f5
- --inverse-foregroundtext-inverse-foregroundoklch(98.5% 0 0)#fafafaoklch(18% 0 0)#121212
- --overlaybg-overlayoklch(19% 0 0 / 0.5)#141414 @ 0.5oklch(0% 0 0 / 0.72)#000000 @ 0.72
InteracciónClaroOscuro
- --primarybg-primaryoklch(52% 0.115 234)#0072a0oklch(82% 0.095 230)#80d0f6
- --primary-foregroundtext-primary-foregroundoklch(99% 0.003 230)#fafcfdoklch(22% 0.04 232)#031e2a
- --secondarybg-secondaryoklch(92.5% 0 0)#e6e6e6oklch(30.5% 0 0)#2f2f2f
- --secondary-foregroundtext-secondary-foregroundoklch(19% 0 0)#141414oklch(97% 0 0)#f5f5f5
- --accentbg-accentoklch(94% 0 0)#ebebeboklch(30.5% 0 0)#2f2f2f
- --accent-foregroundtext-accent-foregroundoklch(19% 0 0)#141414oklch(97% 0 0)#f5f5f5
- --mutedbg-mutedoklch(91.5% 0 0)#e3e3e3oklch(30.5% 0 0)#2f2f2f
- --muted-foregroundtext-muted-foregroundoklch(46% 0 0)#585858oklch(76% 0 0)#b1b1b1
- --muted-strongtext-muted-strongoklch(36% 0 0)#3d3d3doklch(87% 0 0)#d4d4d4
EstructuraClaroOscuro
- --borderborder-borderoklch(88.5% 0 0)#d9d9d9oklch(33.5% 0 0)#373737
- --border-interactiveborder-border-interactiveoklch(60% 0 0)#808080oklch(55% 0 0)#717171
- --inputborder-inputoklch(82% 0 0)#c4c4c4oklch(37% 0 0)#404040
- --ringring-ringoklch(60% 0.115 232)#1c8bb9oklch(82% 0.095 230)#80d0f6
- --ruleborder-ruleoklch(88.5% 0 0)#d9d9d9oklch(33.5% 0 0)#373737
- --grid-colorSolo variable CSSoklch(19% 0 0 / 0.035)#141414 @ 0.035oklch(97% 0 0 / 0.015)#f5f5f5 @ 0.015
FeedbackClaroOscuro
- --destructivebg-destructiveoklch(53% 0.16 27.3)#b63b34oklch(76% 0.15 22.2)#ff8785
- --destructive-foregroundtext-destructive-foregroundoklch(98.5% 0.002 85)#fbfaf9oklch(14.5% 0 0)#0a0a0a
- --destructive-texttext-destructive-textoklch(48% 0.15 27.3)#a1302aoklch(80% 0.13 22.2)#ff9b97
- --destructive-surfacebg-destructive-surfaceoklch(96.5% 0.016 27.3)#fef0eeoklch(24% 0.03 20)#2c1919
- --destructive-borderborder-destructive-borderoklch(87% 0.068 27.3)#fec4bcoklch(34% 0.055 20)#512c2c
- --warningbg-warningoklch(53% 0.108 90.4)#846801oklch(83% 0.111 78.2)#efbe71
- --warning-foregroundtext-warning-foregroundoklch(98.5% 0.002 85)#fbfaf9oklch(14.5% 0 0)#0a0a0a
- --warning-texttext-warning-textoklch(48% 0.098 90.4)#735a00oklch(85% 0.111 78.2)#f6c577
- --warning-surfacebg-warning-surfaceoklch(96.5% 0.028 90.4)#fbf3dfoklch(25% 0.03 80)#292010
- --warning-borderborder-warning-borderoklch(87% 0.07 90.4)#e6d3a0oklch(36% 0.05 84)#4a3b1d
- --successbg-successoklch(53% 0.156 135.6)#3e7e01oklch(80% 0.118 148.9)#86d393
- --success-foregroundtext-success-foregroundoklch(98.5% 0.002 85)#fbfaf9oklch(14.5% 0 0)#0a0a0a
- --success-texttext-success-textoklch(48% 0.14 135.6)#356e03oklch(83% 0.118 148.9)#8fdd9d
- --success-surfacebg-success-surfaceoklch(96.5% 0.028 135.6)#ebf8e6oklch(25% 0.035 153)#14271a
- --success-borderborder-success-borderoklch(87% 0.07 135.6)#c0dfb1oklch(36% 0.06 151)#23462d
- --infobg-infooklch(52% 0.115 234)#0072a0oklch(82% 0.095 230)#80d0f6
- --info-foregroundtext-info-foregroundoklch(98.5% 0.002 85)#fbfaf9oklch(14.5% 0 0)#0a0a0a
- --info-texttext-info-textoklch(45% 0.11 236)#005d89oklch(84% 0.09 228)#89d7f9
- --info-surfacebg-info-surfaceoklch(95.5% 0.028 228)#def4ffoklch(27% 0.04 232)#0f2a37
- --info-borderborder-info-borderoklch(87% 0.06 228)#abddf4oklch(40% 0.06 232)#214d62
CódigoClaroOscuro
- --codebg-codeoklch(94.5% 0 0)#edededoklch(16% 0 0)#0d0d0d
- --code-plainSolo variable CSSoklch(19% 0 0)#141414oklch(92.2% 0 0)#e5e5e5
- --code-commentSolo variable CSSoklch(50% 0 0)#636363oklch(66% 0 0)#929292
- --code-punctuationSolo variable CSSoklch(44% 0 0)#525252oklch(76% 0 0)#b1b1b1
- --code-keywordSolo variable CSSoklch(48% 0.15 300)#6c44a4oklch(81.3% 0.069 301.1)#c9b8e8
- --code-stringSolo variable CSSoklch(48% 0.14 135.6)#356e03oklch(83.1% 0.07 150)#a8d5b0
- --code-functionSolo variable CSSoklch(48% 0.15 260.8)#2759b1oklch(82.1% 0.042 257.5)#b4c6e0
- --code-numberSolo variable CSSoklch(48% 0.098 90.4)#735a00oklch(86.1% 0.066 85.8)#e5cfa0
- --code-tagSolo variable CSSoklch(48% 0.15 27.3)#a1302aoklch(79.4% 0.075 18.9)#e8a9a9
Algunos tokens no tienen utilidad de Tailwind a propósito.
--grid-color solo alimenta las grillas decorativas, y los colores de sintaxis --code-* los lee el bloque de código, no se escriben en el markup.Cómo funcionan los grupos
Surface es el orden de apilado de la interfaz. En modo oscuro las superficies se aclaran a medida que suben: background 14.5%, surface muted 18.2%, card 21.8%, popover 23.9%. Por eso todo lo flotante usa
bg-popover y nunca bg-background: en una página oscura, un menú con bg-background no tiene borde visible.Interactive cubre los rellenos de los controles.
primary es el casi negro (o casi blanco) de los botones principales y los controles marcados, secondary y accent son los rellenos suaves de botones secundarios y estados hover, y muted es el resaltado detrás de los ítems de menú, los tracks y los skeletons. muted-foreground es para leyendas y placeholders, y muted-strong es el color de cuerpo más suave para textos largos.Structure tiene las líneas.
border es el trazo por defecto, border-interactive es el trazo más fuerte que toman los campos en hover y foco, input es el trazo de los campos de formulario y ring es el anillo de foco.Feedback tiene cuatro tonos, cada uno con cinco tokens. Más sobre eso abajo.
Code pinta la superficie del bloque de código y sus tokens de sintaxis, reutilizando los tonos de feedback para que el resaltado quede en la misma familia.
La convención de foreground
Cada superficie o relleno tiene un token
-foreground para el contenido que va encima. La superficie se queda con el nombre pelado y su contenido lleva el sufijo.Si usás un relleno, usá su foreground con él. Mantener cada par legible es trabajo del tema, así que un componente que respeta el par hereda esa garantía en cualquier tema.
Feedback: sólido, texto y superficie
Cada tono de feedback (
destructive, warning, success, info) viene con cinco tokens:| Token | Uso |
|---|---|
--<tono> | Relleno sólido para botones y badges que tienen que destacar |
--<tono>-foreground | Texto e íconos sobre ese relleno sólido |
--<tono>-text | El tono ajustado para texto sobre una superficie normal o su tinte |
--<tono>-surface | Fondo teñido para callouts, banners y toasts |
--<tono>-border | El trazo que acompaña a la superficie teñida |
¿Para qué existe un token
-text si ya está el sólido? Porque el sólido está pensado para llevar un texto claro encima, no para leerse como texto. En modo claro todos los sólidos están en la misma luminosidad de 53%, lo que evita que un estado grite más que otro, pero deja poco margen como texto: success sobre success-surface llega apenas a 4.55:1. Los tokens -text están 5 puntos más oscuros, y eso le da al texto chico un margen real por encima de AA (5.66:1 para el mismo par). En modo oscuro los dos coinciden, porque un tono claro sobre una superficie oscura ya tiene contraste de sobra.La regla es corta: texto e íconos sobre la página o sobre una superficie teñida usan
text-<tono>-text, los controles rellenos usan bg-<tono> text-<tono>-foreground.Info es neutro a propósito en modo oscuro, porque un azul saturado sobre casi negro se lee más fuerte que cualquier otra cosa en la página.
Contraste
Cada par de abajo se mide cuando se construye la página, desde los mismos archivos de tokens, con la fórmula de contraste de WCAG 2.1 después de convertir OKLCH a sRGB. Los pares de texto necesitan 4.5:1 para AA y 7:1 para AAA. Los trazos y anillos de foco son UI no textual, así que su mínimo es 3:1.
| Par | Claro | Oscuro |
|---|---|---|
| foregroundsobre background | 18.46:1AAA | 18.44:1AAA |
| card-foregroundsobre card | 18.46:1AAA | 15.68:1AAA |
| popover-foregroundsobre popover | 18.46:1AAA | 14.66:1AAA |
| inverse-foregroundsobre inverse | 17.68:1AAA | 17.24:1AAA |
| primary-foregroundsobre primary | 5.19:1AA | 10.06:1AAA |
| secondary-foregroundsobre secondary | 14.79:1AAA | 12.28:1AAA |
| accent-foregroundsobre accent | 15.48:1AAA | 12.28:1AAA |
| muted-strongsobre background | 10.86:1AAA | 13.57:1AAA |
| muted-foregroundsobre background | 7.12:1AAA | 9.36:1AAA |
| muted-foregroundsobre card | 7.12:1AAA | 7.96:1AAA |
| muted-foregroundsobre muted | 5.53:1AA | 6.23:1AA |
| destructive-foregroundsobre destructive | 5.47:1AA | 8.53:1AAA |
| destructive-textsobre destructive-surface | 6.34:1AA | 8.19:1AAA |
| destructive-textsobre background | 7.05:1AAA | 9.92:1AAA |
| warning-foregroundsobre warning | 5.07:1AA | 11.60:1AAA |
| warning-textsobre warning-surface | 5.93:1AA | 10.03:1AAA |
| warning-textsobre background | 6.56:1AA | 12.59:1AAA |
| success-foregroundsobre success | 4.78:1AA | 11.07:1AAA |
| success-textsobre success-surface | 5.66:1AA | 9.77:1AAA |
| success-textsobre background | 6.21:1AA | 12.43:1AAA |
| info-foregroundsobre info | 5.12:1AA | 11.56:1AAA |
| info-textsobre info-surface | 6.34:1AA | 9.34:1AAA |
| info-textsobre background | 7.19:1AAA | 12.56:1AAA |
| border-interactivesobre background (no textual) | 3.94:13:1 | 4.14:13:1 |
| ringsobre background (no textual) | 3.85:13:1 | 11.75:13:1 |
muted-foreground sobre muted es el par de texto más ajustado, y aun así pasa AA en los dos modos. Si cambiás un token en tu propio tema, corré el mismo chequeo antes de publicar.Personalizar
Estos son los valores del tema por defecto,
nachui. Para llevar tu propia marca, redefiní las variables en :root y .dark; los componentes solo leen tokens, así que no cambia nada más. Tematización explica el proceso.¿Encontraste algo que mejorar?
¿Notaste un error, tipografía o detalle faltante en esta página? Ayúdanos a mejorar la documentación abriendo un issue en GitHub.