Saltar al contenido

Tokens para diseño

El vocabulario de tokens de TaishoDS Core explicado para diseño, y cómo llevarlos a Figma. Esta página es el contrato compartido entre el código y el archivo de diseño.

Cómo se lee un shade

Cada familia de color tiene 10 shades, de 100 (más claro) a 1000 (más oscuro) en modo claro. No se eligen a mano: el motor los genera en OKLCH a partir de una sola semilla hex, y calcula la rampa espejada para modo oscuro.

Shade Para qué se usa
500El color base de la familia. Es el que representa a la marca.
100 / 200Fondos y bordes suaves (chips, estados sutiles).
700Texto sobre superficies claras. --ts-color-subtle usa gray-700 justamente porque cumple AA.
No se inventan valores intermedios ni se aplica opacidad para "aclarar" un color: rompe el contraste calculado. Si falta un paso en la rampa, es una conversación sobre la semilla.

El contrato -contrast

Cada shade cromático viene con un gemelo -contrast: el color de texto/ícono que el motor garantiza legible sobre ese shade. No hay que elegirlo — ya está resuelto y verificado contra WCAG AA en los tests.

css
/* Fondo brand + su texto garantizado */
background: var(--color-brand-500);
color: var(--color-brand-500-contrast);
Familias ¿Tiene -contrast?
brand, brand-secondary, accentSí — los 10 shades
success, warning, info, dangerSí — los 10 shades
gray, grayAlpha, background, overlayNo (son superficies, no fondos de marca)

Estados y densidad

Los cuatro estados (success, warning, info, danger) no son un color suelto: cada uno trae un juego de sub-tokens listo para armar una pieza completa.

css
--ts-color-danger           /* el color base (shade 500) */
--ts-color-danger-bg        /* fondo suave (shade 100) */
--ts-color-danger-border    /* borde (shade 200) */
--ts-color-danger-text      /* texto sobre fondo claro (shade 700) */
--ts-color-danger-contrast  /* texto sobre el color base */

Densidad: alturas de control y paddings existen en dos juegos — comfortable (default) y compact. Se cambian de una, en runtime, sin recompilar. Al diseñar, se define la pantalla en comfortable y se comprueba que respire en compact.


Llevar los tokens a Figma

El motor exporta los tokens en formato DTCG (el estándar del Design Tokens Community Group), generados de la misma fuente que el CSS — no hay una lista paralela que se pueda desincronizar. Así se mapean a Figma:

En el JSON (DTCG) En Figma
Grupo raíz (color, sizing, spacing…)Colección de Variables
$valueValor del modo light
$extensions["com.taishods"].darkValor del modo dark
$extensions["com.taishods"].hexValor de la Variable de color (Figma no lee OKLCH)
Alias {color.gray.1000}Alias a otra Variable
$type: dimension { value, unit }Variable FLOAT (px)
$type: shadowEffect Style (Figma no soporta Variables de sombra)
Los colores se guardan en OKLCH, que Figma no interpreta. Por eso cada color trae un hex equivalente en $extensions: ese es el que hay que importar. El OKLCH sigue siendo la fuente de verdad del código.

Tokens del tema taisho (el que usa esta documentación).