Apariencia
Tokens CSS
Tres archivos: la base, que comparten todos, y uno por plataforma con lo que cambia.
| Archivo | Contiene |
|---|---|
/ts/tokens.css | Color, tipografía (familia y pesos), radio de píldora, movimiento |
/ts/tokens-pos.css | Tamaños de texto, radios y medidas táctiles del POS, colores de teclas y barras |
/ts/tokens-web.css | Tamañ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-bodyes "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.