Skip to content

Tokens CSS ​

Tres archivos: la base, que comparten todos, y uno por plataforma con lo que cambia.

ArchivoContiene
/ts/tokens.cssColor, tipografía (familia y pesos), radio de píldora, movimiento
/ts/tokens-pos.cssTamaños de texto, radios y medidas táctiles del POS, colores de teclas y barras
/ts/tokens-web.cssTamaños de texto, radios y medidas de los paneles

Usarlos ​

La fuente está en el monorepo, en design/tokens/. Las apps del monorepo los importan desde ahí, nunca los copian:

css
/* web/admin/src/modules/shared/ui/tokens.css */
@import '../../../../../../design/tokens/tokens.css';
@import '../../../../../../design/tokens/tokens-web.css';   /* o tokens-pos.css */

Vite los resuelve y los incluye en el CSS de la app al compilar; no hace falta configurar nada. Una app fuera del monorepo los toma del sitio (/ts/tokens.css) o del paquete de su plataforma (npm run bundle).

css
.mi-componente {
  padding: 16px;
  border-radius: var(--ts-radius-control);
  background: var(--ts-surface);
  color: var(--ts-text);
  font-size: var(--ts-text-body);
  font-weight: var(--ts-weight-medium);
}

Reglas ​

  • Nunca un valor suelto de color, radio, peso o tamaño de texto. Si falta un token, se propone aquí.
  • Los nombres son los mismos que ya usan las apps (--ts-*): adoptarlos no pide renombrar nada.
  • Un token de plataforma nunca cambia de significado entre POS y web, solo de valor (--ts-text-body es "el texto normal" en los dos).
  • No se crean tokens por componente (--ts-toast-bg) mientras el valor se use en un solo lugar.

De dónde salen ​

v0.1.0 se armó a partir de los tokens.css del POS y de los tres paneles (web/admin, web/platform, web/store), que eran copias que se habían separado. Lo unificado:

  • Archivo en todo (antes el POS usaba Geist) ✅.
  • Pesos iguales en todo: 300 / 380 / 480 / 600 ✅.
  • Rojo de acción (--ts-accent) para lo irreversible en las dos plataformas; el violeta queda solo para resaltar.
  • Nuevos 🔜: movimiento (--ts-motion-*), medidas (--ts-control-height, --ts-key-height*), --ts-font-mono.

En las apps ✅ ​

El POS y los tres paneles importan design/tokens/ desde su tokens.css. En el tokens.css de cada app solo quedan las medidas propias de sus pantallas (por ejemplo, el ancho de la tarjeta del logo del POS).

Pendiente 🔜: cambiar por su token los valores sueltos que todavía quedan en el CSS de cada app.