Apariencia
Catálogo de componentes
Las piezas que comparten los productos. Antes de crear una nueva, busca aquí: si existe, se usa; si le falta algo, se propone el cambio en este sistema, no una copia en tu app.
| Componente | POS | Web | Para |
|---|---|---|---|
| Botón | ✅ | ✅ | Acciones |
| Campo de texto | ✅ | ✅ | Escribir un dato |
| Teclado táctil | ✅ | — | Escribir sin teclado físico |
| Tarjeta | ✅ | ✅ | Agrupar contenido |
| Ventana | ✅ (modal y hoja) | ✅ (diálogo) | Una tarea encima de la pantalla |
| Aviso (toast) | ✅ | ✅ | Resultado de una acción |
| Chip y filtro | ✅ | ✅ | Estados y filtros |
| Skeleton | ✅ | ✅ | Mientras carga |
Convenciones
- Clases con prefijo
ts-y estilo BEM:ts-button,ts-button--primary,ts-toast__icon. El teclado táctil usatk-. - Colores y medidas por token, nunca valores sueltos.
- Cada componente de React vive en
src/modules/shared/ui/de cada app, con su CSS al lado (Button.tsx+components.css). 🔜 Se mudarán a un paquete compartido (React). - Textos fuera del componente, en el archivo de idioma.
Proponer un componente nuevo
- Que lo necesiten dos pantallas o más.
- Documentarlo aquí: para qué es, sus variantes, medidas por plataforma, estados y reglas, con el formato de las demás páginas.
- Después, el código.