Diseño de sistemas: un solo lenguaje para todos
Neutro en la base, vivo en los datos. La estructura (fondos, menú, bordes) es calma y neutra, y encima los datos tienen color, forma y movimiento: gráficos, avance, personas y proyectos con su color. Una pantalla sin gráficos, sin color por entidad y sin un protagonista se siente muerta. Ver la sección "Vida" y abrir 06, 07, 08 y 14 antes de diseñar un tablero. Varios sistemas de una misma empresa se sienten de la misma familia porque comparten tokens, tipografía, radios, estados y piezas. Lo que cambia por sistema es el acento y el tinte de los neutros.
Neutro no quiere decir gris. La base puede tener el tono que pida la marca o el uso de cada sistema:
- Tinte de marca: fondo con un leve tinte del acento, por ejemplo un violeta o un azulado muy suave.
- Fondo con tono: un fondo con tono y un menú de marca oscuro y apagado (por ejemplo azul marino) en vez del blanco plano.
- Cálido o frío según el rubro.
- Oscuro para monitoreo.
La regla es la saturación y el contraste, no el color: los neutros llevan croma muy bajo (OKLCH C ≤ 0,02, o hasta ~0,03 en el lienzo), siempre del mismo tinte en todo el sistema. Tienen que dejar que los estados y el acento se lean como lo único con color de verdad. Los hex grises de este documento son el punto de partida, no una obligación: cada sistema arma su rampa de neutros con su tinte (ver tokens.css).
-
Tokens listos para pegar:
tokens.css. Nombres en español (fondo,superficie,tinta,texto-2,acento,verde-fondo…). -
Ejemplos en
ejemplos/:tablero-crm.html: pantalla completa de un CRM.componentes.html: galería de todas las piezas, con claro, oscuro y celular.recetas-tailwind.md: las piezas en React + Tailwind v4 para copiar.
Abrilos y sufénalos.
-
Capturas de referencia:
referencias/01…14-*.jpg. Abrí la que corresponda antes de diseñar algo parecido. -
Análisis completo por tema, con valores y ejemplos:
analisis/01-estructura.md…analisis/15-homogeneidad.md. Leé el del tema que estés tocando.
Si existe marcas.local.md en esta carpeta, leelo primero: tiene el acento, el tinte y las reglas propias de cada marca de quien usa la skill. Lo que diga ahí manda sobre los valores de ejemplo de este documento.
Receta rápida para una pantalla nueva:
- Elegí qué pantalla es (tablero, lista, ficha, calendario, formulario, celular) y abrí su referencia y su ejemplo en
ejemplos/. - Definí el acento y el tinte de los neutros del sistema (
tokens.css). - Armá el marco: barra lateral sobre el lienzo y el panel con migas de pan.
- Escribí la cabecera: título display grande y liviano, subtítulo con cifras reales, un solo botón relleno.
- Fila de 3 a 6 KPIs: uno protagonista y el resto en bandeja con tarjeta adentro, cada uno con su dibujo.
- Cuerpo: tarjetas de entidad para lo que está en curso, tabla o lista para el resto y un panel lateral de contexto.
- Dale vida: color por entidad, avatares, un gráfico con estado y movimiento al cargar.
- Diseñá los estados vacío, cargando y error (sección 6b).
- Probala a 390 px y en oscuro.
- Pasá la lista de la sección 8, comparándola al lado de las referencias.
Principios de base: fricción cero, una acción principal por pantalla, nada de textos de relleno, y todo botón que lleva a una lista te deja parado en la fila que corresponde.
1. Marco de la app (referencias 02, 03, 07, 13)
- El lienzo es
bg-fondo(#F4F4F5). La barra lateral va directo sobre el lienzo, de 240–256 px. - El contenido va en un panel
bg-panelobg-superficie,rounded-[var(--radius-marco)], separado 8 px del borde y de la barra, con borde de 1 px. - Barra lateral:
- Arriba, logo o selector de empresa. Opcionalmente, buscador ⌘K.
- Grupos con rótulo de 11 px en
texto-3, mayúscula ytracking-wider. - Ítems de 32–36 px con ícono de 16 px gris y conteo gris a la derecha.
- El ítem activo es una pastilla
bg-superficie(obg-tinta text-white): nunca color de marca. - Usuario (avatar, nombre y rol) al pie.
- Barra superior del panel: 56 px con
border-b. A la izquierda, migas de pan ("Sección / Página", el padre en gris). A la derecha, buscador ⌘K, avisos y avatar. - Cabecera de página:
- Título de 20–24 px, peso 500–600,
tracking-tight. - Debajo, un subtítulo gris con cifras reales del estado: "12 por facturar · 3 vencidas", nunca una descripción genérica.
- Acciones a la derecha, en la misma fila.
- Título de 20–24 px, peso 500–600,
- Orden vertical fijo: cabecera → filtros y vista (segmentado) → fila de KPIs → cuerpo.
- Cuerpo con contexto:
grid-cols-[1fr_360px], con lista o calendario a la izquierda y panel de detalle a la derecha (01, 02, 07). - Ficha: 3 columnas
[1fr_1.6fr_1fr], con datos, actividad en pestañas con conteo y la empresa relacionada (03).
1b. Vida (lo que hace que no sea una planilla prolija)
Mirá 06 (Gr8r), 07 (Loops), 08 (Finora) y 14 (Solexa). Todo tablero lleva al menos 5 de estos recursos:
-
Color por entidad. Cada proyecto, cliente, persona o servicio tiene su color fijo, de la paleta de datos y asignado por id. Aparece en:
- su ícono o avatar;
- su barra de avance;
- su sparkline;
- la rayita de la tabla. Es lo que más vida da (06: cada proyecto y cada persona con su color).
-
Toda cifra con un dibujo. Un sparkline con área degradé, una barra de ticks (07: rayitas finas coloreadas hasta el %), una barra segmentada (06: bloques de 1 de 10) o un anillo de avance (09, 13, 14). Un número solo es un número muerto.
-
Un protagonista por pantalla. Una tarjeta llena de color con degradé del acento, cifra grande en blanco y un gráfico de línea blanco con un punto marcado (08 "Total Expenses", 09 "halfway there").
-
Tarjetas de entidad, no solo tablas. Para lo que está "en curso" (proyectos, servicios, oportunidades grandes) van tarjetas en grilla como en 06:
- pastilla de prioridad y etiquetas;
- título grande con descripción de 2 líneas;
- barra segmentada con "3 de 6 hechas · Vence 15 dic";
- sparkline de actividad;
- "Próximos pasos" con checks y "+ Agregar".
-
Gente con cara. Foto o avatar ilustrado. Si no hay, monograma de color. Pilas de avatares superpuestos para participantes. El equipo va en tarjetas con su barra de carga (06 "Team").
-
Gráficos con estado. La barra o el punto activo va sólido y el resto rayado o tenue. Tooltip oscuro con "valor | participación | vs. otro" (08). Mes en curso rayado "MTD" (07).
-
Fondo con clima. Un degradé muy suave del tinte del sistema en la parte de arriba del panel (08), o una foto o ilustración en la franja de cabecera (14) o en la tarjeta de promo o plan (06 y 14, ilustración de línea).
-
Movimiento con propósito. Al cargar, las cifras cuentan hasta su valor (~600 ms), las barras crecen desde 0 y las líneas se dibujan. Al pasar el mouse, la tarjeta sube 1–2 px y el borde se marca. El éxito se ve en el lugar con un toast. Todo
ease-outy respetandoprefers-reduced-motion. -
Bandeja con tarjeta adentro (lo que se ve "premium"). El KPI no es una caja plana: es una bandeja
bg-suavecon radio 16 y padding 4 que lleva:- arriba, el rótulo con ícono y ⋯ sobre la bandeja (07);
- adentro, una tarjeta blanca con radio 12, el número y su dibujo;
- abajo, el pie sobre la bandeja con ícono, contexto y delta (06). Mismo patrón para los íconos: un cuadrado blanco de 36–40 px con borde y sombra mínima, sobre la bandeja (08).
-
Aire. Padding generoso (20–24 en tarjetas grandes) y gaps de 16–20. Cifras de 28–40 px. Lo premium respira: si se ve apretado, sacá cosas antes que achicar.
Límite: el color vive en los datos, las entidades y un protagonista. El marco (menú, fondos, bordes, textos) sigue neutro.
2. Tipografía (análisis 02)
- Dos voces, no una:
- Display para títulos, saludo y cifras: una geométrica o grotesca con carácter como Outfit, General Sans, Satoshi o Plus Jakarta (08 usa una de este tipo).
- Texto para la interfaz: Plus Jakarta Sans, Manrope o Inter.
- Mono con personalidad (JetBrains Mono, Geist Mono) para códigos (PR-0241, FAC-01101) y, en tableros técnicos o de monitoreo, también para las cifras (14).
- Geist o Inter solas quedan "básicas".
- Títulos grandes y livianos: el saludo o título de página va a 36–44 px en peso 400, con
tracking-tight(06 "Good evening, Alex", 08). Lo grande no necesita negrita. - Escala: 11 / 12 / 13 / 14 / 16 / 20 / 24 / 32 / 40. Una tarjeta no mezcla más de 3 tamaños.
- Pesos: 400 texto y títulos grandes, 500 títulos de tarjeta y acciones, 500–600 cifras. Nada de 700.
- Dato = rótulo gris de 12–13 px arriba y valor
tintade 14 px abajo. Nunca "Rótulo: valor" en la misma línea dentro de una ficha. - Cifras con
tabular-nums, montos alineados a la derecha. El símbolo de moneda, los centavos y la unidad van entexto-3, un paso más chicos:$ 24.957,81. - Metadatos en una línea de 12 px gris, unidos con " · ": "Cobranzas · FAC-01101 · hace 2 min".
- La mayúscula queda solo para los rótulos de grupo del menú. Encabezados de tabla, botones y pestañas van en minúscula inicial.
3. Color (análisis 03)
-
Hay tres planos (
fondo→panel→superficie) y la profundidad sale del tono más un borde de 1 px y sombras mínimas (ver la sección 4). -
Neutros a medida de cada sistema:
- Una sola rampa: cada sistema elige el tinte de sus neutros (de su marca o de su uso) y lo usa en toda la rampa: fondo, panel, bordes y los tres textos.
- Croma bajo: el tinte tiene que notarse como "clima", no como color. Si el fondo compite con una pastilla de estado, está demasiado saturado.
- Sin mezclas: nunca combinar una rampa fría y una cálida en el mismo sistema.
- Puede ir más allá del gris: un fondo con tono o un menú oscuro de marca también son válidos. La condición es que el contenido siga en superficies claras y legibles, con los estados como la única nota fuerte.
-
Texto en
tinta/texto-2/texto-3, que son neutros con el mismo tinte. Prohibido#000sobre#FFF. -
Un solo acento por sistema, usado solo en el botón principal, el toggle, el foco, el punto de no leído y la pestaña activa del celular. Nunca en títulos, fondos de tarjeta ni el menú.
-
Acento por sistema: cada sistema o empresa tiene un solo acento (su color de marca). Si no tiene marca definida, grafito
#18181B. El resto de la skill es igual para todos. -
Estados = pastilla: fondo al 10 % + texto saturado + punto de 6 px. Nunca un fondo saturado con texto blanco y nunca solo color: siempre con palabra.
- Verde: hecho, cobrado, en línea.
- Ámbar: pendiente, parcial, por vencer.
- Rojo: vencido, falló, sin conexión.
- Azul: en curso, informativo.
- Gris: borrador, anulado, reintegrado.
-
Lo normal no se colorea. El rojo es solo para lo que exige actuar. Si hay más de 3 rojos en la pantalla, se agrupan en un aviso.
-
La paleta de datos (
dato-1…6, máximo 6) vive solo en gráficos, barras de progreso e íconos de tipo. En una tabla se repite como rayita de 3 px, nunca pintando la fila. -
Lo proyectado, parcial o no seleccionado va rayado o al 30 %; lo real, sólido. Por ejemplo, el mes en curso "MTD" (07, 08).
-
Como máximo una tarjeta héroe rellena de color por pantalla (08, 09).
-
Antes de terminar, contá los colores: grises + 1 acento + hasta 4 de estado + hasta 6 de datos.
4. Superficies, radios y espacios (análisis 04)
Radios en capas. Cada nivel adentro va un poco menos redondeado que el que lo contiene (radio interno ≈ radio externo − padding). No inventar otros valores:
| Elemento | Radio |
|---|---|
| Marco de la app (todo el sistema en una caja) | 26 |
| Panel principal | 20 |
| Tarjeta / bandeja / hoja | 20 |
| Tarjeta dentro de la bandeja | 16 |
| Botón / campo / buscador / ícono en cuadro | 11–12 |
| Botón chico / pastilla / etiqueta | 7–9, o redonda para filtros y "+12 %" |
En celular, las tarjetas van a 20–24.
Espacios. Escala 4 / 8 / 12 / 16 / 20 / 24 / 32 / 40, sin 10, 14 ni 18.
- Padding: 16–20 en tarjeta (12 si es densa o en celular) y 26–28 en panel.
- Gap de grilla: 14.
- Entre bloques grandes: 28.
- Entre secciones: 32–40 de aire más un título. Nunca una línea gruesa ni un fondo de color.
Bordes y sombras.
- Borde siempre de 1 px
borde. Nada de 2 px ni bordes de color, salvo el foco. - Sombras en tres niveles, siempre suaves y del tono de la tinta (nunca negro puro):
- Mínima (
0 1px 2px /.05): en botones con borde, la tarjeta dentro de la bandeja, el ítem activo del menú y los íconos en cuadro. Es lo que les da "relieve" premium. - Al pasar el mouse (
0 14px 30px -18px /.3, junto con subir 2 px): en las tarjetas clickeables. - Flotante (
0 24px 48px -16px /.22): en menú, hoja, modal y toast. El botón negro principal lleva sombra propia y un brillo arriba (inset 0 1px 0 /.12). - Una tarjeta quieta de contenido va con borde, sin sombra grande.
- Mínima (
Subdivisiones. Para subdividir una tarjeta, usá bandas a todo el ancho (border-t o un fondo suave) o el patrón bandeja + tarjeta blanca (ver "Vida", punto 9). Lo que no va es apilar tres niveles de cajas con borde. Las métricas en fila se separan con divide-x.
5. Piezas
Tarjeta KPI (06, 07, 13, 14 · análisis 06)
- Lleva rótulo + número + línea de contexto, siempre. Un número sin su "de qué" o "respecto de qué" no va.
- El número va en
tinta(24–28 px, 600,tabular-nums). El color va solo en el delta, la pastilla o la barra. - El delta dice su período ("+12 % vs. mes anterior", "+3 esta semana"), lleva flecha ↗/↘ y su color sale de si es bueno o malo para el negocio, no del signo: si baja la mora, es verde.
- Si hay algo vencido, el pie lleva un ícono de alerta y un texto rojo con cuántos ("2 vencidas · Requiere atención").
- El avance contra un objetivo se indica con una barra de ticks (a la mitad del KPI) o un gráfico de anillo con el número adentro. Un número solo flotando es un KPI muerto.
- Siempre en bandeja (ver "Vida" punto 9). La bandeja tiene el rótulo arriba y el contexto abajo.
Botón principal (referencia 06, 08)
- Uno por pantalla, y llama a la acción principal de esa vista.
- Va a la derecha en la cabecera, o justo debajo del título en celular.
- Fondo
bg-acentoobg-tinta, texto blanco, padding horizontal 20–24 y vertical 10–12. Radio 11. Sombra flotante propia y brillo superior. - Tamaño: 36–40 px de alto. Con ícono de 16–18 px opcional a la izquierda.
- No hay botón secundario; los demás son botones de texto o con borde.
- Los botones con borde tienen fondo transparente, borde de 1 px, texto
tinta, radio 10. Conhover:bg-suave. - Los botones de texto no tienen fondo, solo texto
texto-2otexto-3conhover:text-tinta. - En celular, los botones son a todo lo ancho y crecen a 44 px de alto.
Tabla (referencia 01, 02, 07 · análisis 07)
- Sin líneas verticales. Solo
border-bde 1 px entre filas, enborde. El encabezado no tiene fondo: solo textotexto-3de 12 px en mayúscula. - Filas de 48–52 px. Al pasar el mouse, fondo
bg-suave. - Checkbox al inicio solo si la tabla permite selección múltiple. Nunca columna de edición.
- La fila activa o seleccionada lleva una rayita de 3 px en
dato-*a la izquierda. - Dos renglones por fila cuando hay metadatos (por ejemplo, nombre + email debajo).
- En celular, la tabla se convierte en lista de tarjetas: cada fila es una tarjeta de 100 % de ancho con los campos apilados.
- Paginación: abajo a la derecha, o infinita scroll con "Mostrar más". Sin el clásico 1 2 3.
Formulario (referencia 09 · análisis 08)
- Una columna, 100 % del ancho del contenedor. Sin columnas paralelas.
- Etiqueta arriba del campo, en
texto-3de 13 px. El campo: borde de 1 pxborde, radio 10, padding 12 px, fondobg-panel. - Placeholder en
texto-3, no en gris claro ilegible. - Estados:
- Normal: borde
borde. - Foco: borde
acentocon un anillo de 2 px y sombra mínima (0 0 0 3px / .15). - Error: borde rojo con mensaje rojo de 12 px debajo y un ícono de alerta a la derecha.
- Válido: ícono de check verde a la derecha.
- Deshabilitado: opacidad 50 %, sin sombra.
- Normal: borde
- Los campos largos (textarea) crecen hasta 4 líneas y tienen indicador de caracteres.
- Select: dropdown nativo del sistema o un select estilizado con el mismo radio y borde. El menú desplegable sigue el patrón de sombra flotante.
- Checkbox y radio: cuadro de 16–18 px con borde, radio del checkbox 4 y del radio 50 %. El activo lleva el acento de fondo.
- Acciones: botón principal abajo a la izquierda (o a la derecha si es solo el formulario) y cancelar como texto a la izquierda.
- Validación en tiempo real cuando el usuario sale del campo (onBlur). Errores de envío se muestran como un banner rojo arriba del formulario.
6. Estados y transiciones (análisis 11)
6a. Estados de carga
- Los contenedores ya existen con el mismo tamaño que ocuparán con datos. Sin saltos de layout.
- Skeleton: un degradé animado de
bg-suaveabg-panelen loop (1.5 s). Forma de caja para tarjetas y filas. Las cifras se simulan con un rectángulo del ancho del número. - Duración: no menos de 300 ms; si es más rápido, se saltea para evitar parpadeo.
- El skeleton no tiene radio, solo el contenedor. No es animación de brillo, es un pulso de opacidad.
6b. Estado vacío
- Ilustración (o ícono grande de 48 px) + título de 16 px + descripción de 14 px + botón de acción. Centrado en el contenedor.
- Nunca "No hay datos". Decí qué esperar: "Todavía no cargaste clientes. Empezá importando tu lista."
- Si es una lista filtrada, mostrá "No hay resultados para estos filtros" con botón para limpiarlos.
6c. Estado de error
- In-situ, no una página aparte. El contenedor muestra un mensaje con ícono de error y un botón "Reintentar".
- Si el error es global (pérdida de conexión), un banner fijo arriba de todo: "Sin conexión. Los cambios se guardarán cuando vuelvas."
7. Animación y transiciones
- Suaves y funcionales. Todo cambio de estado es
ease-out, duración 200–300 ms. Sin movimientos superfluos. - Al cargar: fade in de 200 ms para todo el contenido. Los elementos entran escalonados cada 50 ms (stagger).
- Hover en tarjetas: subida de 2 px y sombra al pasar el mouse, con transición de 150 ms.
- Tooltip: fade in 100 ms, retardo 300 ms. Aparece arriba del elemento.
- Toast: slide desde arriba, permanece 4 s y se desvanece. Con ícono de éxito, error o advertencia.
- Modal: backdrop con opacidad 50 % y fade in de 200 ms. El contenido escala de 0.95 a 1.
- Respeto por
prefers-reduced-motion: sin animaciones, transiciones instantáneas.
8. Checklist de calidad
Antes de dar por terminada una pantalla, verificá:
- Contraste: todo texto cumple WCAG AA (4.5:1 normal, 3:1 grande). Probá con un validador.
- Toque: todos los elementos clickeables tienen al menos 44×44 px en celular.
- Foco: hay un anillo de foco visible en todos los elementos interactivos (no solo
:focus-visible). - Teclado: se puede navegar toda la pantalla con Tab y Enter, en orden lógico.
- Estados: ninguna tarjeta, botón o campo se queda sin estado hover, focus y active.
- Datos reales: no hay textos de relleno ("Lorem ipsum", "Nombre del cliente"). Si no hay datos, mostrá el estado vacío.
- Cifras con dibujo: todo número tiene un gráfico asociado (sparkline, barra, anillo).
- Protagonista: hay al menos una tarjeta o sección que destaque visualmente.
- Color por entidad: proyectos, clientes o personas visibles tienen su color asignado.
- Bandeja: los KPIs y elementos destacados usan el patrón bandeja + tarjeta blanca.
- Aire: no hay elementos apretados. El padding es generoso.
- Celular: la pantalla funciona y se ve bien a 390 px de ancho.
- Oscuro: el tema oscuro está implementado y probado.
- Movimiento: las animaciones de carga y hover están implementadas y respetan
prefers-reduced-motion. - Contra referencias: la pantalla se ve igual o mejor que la referencia correspondiente.
9. Archivos y estructura
skill/
├── tokens.css # Tokens CSS (fondo, superficie, tinta, etc.)
├── marcas.local.md # (opcional) Reglas por marca
├── ejemplos/
│ ├── tablero-crm.html # CRM completo
│ ├── componentes.html # Galería de componentes
│ └── recetas-tailwind.md # Recetas React + Tailwind v4
├── referencias/
│ ├── 01-tablero.jpg
│ ├── 02-lista.jpg
│ ├── 03-ficha.jpg
│ ├── 04-calendario.jpg
│ ├── 05-formulario.jpg
│ ├── 06-gr8r.jpg
│ ├── 07-loops.jpg
│ ├── 08-finora.jpg
│ ├── 09-form.jpg
│ ├── 10-celular.jpg
│ ├── 11-oscuro.jpg
│ ├── 12-bandeja.jpg
│ ├── 13-anillo.jpg
│ └── 14-solexa.jpg
├── analisis/
│ ├── 01-estructura.md
│ ├── 02-tipografia.md
│ ├── 03-color.md
│ ├── 04-superficies.md
│ ├── 05-piezas.md
│ ├── 06-kpi.md
│ ├── 07-tabla.md
│ ├── 08-formulario.md
│ ├── 09-estados.md
│ ├── 10-animacion.md
│ ├── 11-accesibilidad.md
│ ├── 12-celular.md
│ ├── 13-oscuro.md
│ ├── 14-vida.md
│ └── 15-homogeneidad.md
└── README.md # Este documento
10. Contribución y evolución
Este sistema de diseño vive en cada skill que lo usa. Si encontrás una inconsistencia o una pieza que debería estar documentada, actualizá los análisis y ejemplos correspondientes. Las reglas de marca en marcas.local.md tienen prioridad sobre este documento.
Para proponer cambios globales, discutilos primero en el equipo de diseño y validalos con implementaciones de prueba antes de actualizar la skill.