Communitygithub.com

diseño-sistemas

Lenguaje visual y UX para sistemas de gestión como CRMs, ERPs, dashboards internos y portales B2B, en escritorio y móvil. Úsalo al diseñar o revisar esas interfaces.

Qu'est-ce que diseño-sistemas ?

Esta skill define un sistema de diseño completo y coherente para aplicaciones de gestión empresarial (CRMs, ERPs, dashboards B2B). Proporciona un lenguaje visual unificado basado en tokens CSS, ejemplos prácticos y un análisis detallado de cada aspecto (estructura, tipografía, color, superficies, componentes). Está diseñada para Claude Code, Cursor y Codex, y se apoya en archivos como `tokens.css`, `ejemplos/*.html`, `analisis/*.md` y `referencias/*.jpg`. La skill enfatiza que la interfaz debe ser neutra en su estructura (márgenes, menús, fondos) pero vibrante en los datos: colores por entidad, gráficos con movimiento, un protagonista por pantalla y métricas con representación visual. Su objetivo es que múltiples sistemas de una misma empresa se sientan de la misma familia, cambiando solo el acento y el tinte de los neutros. Incluye recetas rápidas para crear pantallas nuevas, principios de diseño (fricción cero, una acción principal, sin textos de relleno) y reglas estrictas para radios, sombras, espacios, tipografía y colores.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/brandon4320/skill-diseno-sistemas/tree/HEAD

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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 superalos.

  • 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:

  1. Elegí qué pantalla es (tablero, lista, ficha, calendario, formulario, celular) y abrí su referencia y su ejemplo en ejemplos/.
  2. Definí el acento y el tinte de los neutros del sistema (tokens.css).
  3. Armá el marco: barra lateral sobre el lienzo y el panel con migas de pan.
  4. Escribí la cabecera: título display grande y liviano, subtítulo con cifras reales, un solo botón relleno.
  5. Fila de 3 a 6 KPIs: uno protagonista y el resto en bandeja con tarjeta adentro, cada uno con su dibujo.
  6. Cuerpo: tarjetas de entidad para lo que está en curso, tabla o lista para el resto y un panel lateral de contexto.
  7. Dale vida: color por entidad, avatares, un gráfico con estado y movimiento al cargar.
  8. Diseñá los estados vacío, cargando y error (sección 6b).
  9. Probala a 390 px y en oscuro.
  10. 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-panel o bg-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 y tracking-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 (o bg-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.
  • 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:

  1. 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).
  2. 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.
  3. 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").
  4. 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".
  5. 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").
  6. 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).
  7. 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).
  8. 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-out y respetando prefers-reduced-motion.
  9. Bandeja con tarjeta adentro (lo que se ve "premium"). El KPI no es una caja plana: es una bandeja bg-suave con 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).
  10. 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 tinta de 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 en texto-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 #000 sobre #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:

ElementoRadio
Marco de la app (todo el sistema en una caja)26
Panel principal20
Tarjeta / bandeja / hoja20
Tarjeta dentro de la bandeja16
Botón / campo / buscador / ícono en cuadro11–12
Botón chico / pastilla / etiqueta7–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.

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: "100 de 450 evaluaciones" con una barra de avance mínima.
  • En móvil, las tarjetas KPI apiladas en una columna vertical, con una tarjeta menos densa.

Tablas (01, 02, 07 · análisis 07)

  • Sin líneas verticales, solo border-b finito entre filas.
  • Cabecera pegajosa con texto-3 de 12 px, bold ligero, sin fondo. Nunca un fondo gris de cabecera.
  • Una fila mide 48–56 px. La celda izquierda puede tener un avatar de 28 px + texto; la derecha, un delta o una pastilla.
  • Checkbox de 16 px a la izquierda, solo si hay acción masiva. No como adorno.
  • La fila activa tiene un borde izquierdo de 3 px del acento.
  • Desplegable: fila que se expande con un panel de 112–160 px, fondo bg-panel sin borde, con la misma información que una ficha rápida (04).
  • Paginación: "Mostrando 1–12 de 48" + botones de página sin adornos. No van "< anterior" y "siguiente >" con formato de botón.
  • Sin hover de color: las filas son blancas o se toman con un fondo extremadamente sutil (.02). Nunca un hover de color que opaque una pastilla o un avatar.

Formularios (05 · análisis 08)

  • Modo natural: un campo por línea, con rótulo arriba a la izquierda en texto-3. El valor se escribe solo cuando el usuario escribe. No hay textos de ayuda grises dentro del campo.
  • Estados visuales: border → al enfocar acento + outline → error rojo + ícono de alerta a la derecha → éxito verde + tilde.
  • Botones:
    • Principal: relleno del acento o negro, 40 px con radio 11–12, tracking-tight, sin ícono.
    • Secundario: border con texto en tinta, 40 px.
    • Terciario: solo texto, gris, 36 px, sin borde.
    • Todos con estados hover, active y disabled. Los botones no se estiran a lo ancho del contenedor.
  • Select: mismo estilo que el campo, con un caret personalizado.
  • Fecha: el input recibe el formato "DD.MM.AAAA" y se valida. El datepicker es el nativo del navegador, a menos que se requiera un selector de rango personalizado.
  • Búsqueda en selector: input con ícono de lupa + resultados filtrados en dropdown.
  • Switch: toggle de 36 px del acento con fondo gris cuando está apagado.
  • Checkbox/Radio: círculo de 18 px, borde de 2 px, relleno de acento al seleccionar.
  • Los errores aparecen debajo del campo en rojo de 12 px, con un ícono de alerta de 14 px. Nunca un popup.
  • Validaciones en tiempo real después de que el usuario termina de escribir (debounced).
  • Campos deshabilitados: opacidad al 40 %, sin cursor pointer.
  • Conjunto de campos: agrupar con un borde y un legend gris.
  • Botón de envío: siempre deshabilitado hasta que el formulario sea válido. Al enviar, mostrar estado de carga.

Navegación (menú, pestañas, migas de pan) (01, 02, 13)

  • Menú lateral: como en la sección 1.
  • Pestañas en el panel: 32–36 px, con borde inferior de 2 px del acento en la activa. Las inactivas son texto-2. No se mezclan pestañas con segmentado.
  • Segmentado: control de 3–4 opciones en una fila, activa con fondo blanco y sombra mínima. Usado para cambiar entre vistas (ejemplo: "Gráfico / Tabla / Detalle").
  • Breadcrumbs: "Sección / Página", con el padre en texto-2 y el actual en tinta. Con chevron de 12 px entre ítems.
  • Menú contextual: en ícono de tres puntos (⋯) o clic derecho. Lista de ítems con ícono de 16 px + texto, con separador opcional.
  • Menú desplegable (dropdown): de un botón o avatar. Misma estructura que el contextual.
  • Tooltip: texto corto, fondo de tinta casi negro, texto blanco, radio 8, flecha apuntando al elemento.
  • Modal: fondo oscuro con opacidad, panel blanco con radio 20, padding 28, título de 18 px + cierre (X) + cuerpo + acciones (botones secundario y principal).
  • Hoja (slide-out): panel lateral desde la derecha, 360–420 px, con fondo oscuro. Misma estructura que el modal.
  • Notificaciones: toast en la esquina inferior derecha, con ícono + texto + botón de cierre. Verde para éxito, rojo para error, ámbar para advertencia. Auto-dismiss a los 4 segundos.

Gráficos y visualizaciones (06, 07, 08, 14 · análisis 10)

  • Sparkline: línea delgada con área degradada. La línea es de 2 px del color de la entidad, el área se desvanece hasta un 10 % de opacidad.
  • Barra de avance: barra del color de la entidad, con ticks cada 10 % (07). Si está completa, se marca con un ícono de check.
  • Anillo de avance: círculo con trazo de 8 px del color de la entidad, fondo gris claro. El porcentaje va en el centro.
  • Gráfico de barras: barras del color de la entidad, con espacio de 4 px entre barras. La barra activa es más oscura.
  • Gráfico de líneas: línea suave (catmull-rom), con puntos en los datos. Tooltip con valor y fecha.
  • Calendario: grilla de 7 columnas, con el día actual en un círculo del acento. Los eventos se muestran como puntos de colores.
  • Mapa: solo para ubicaciones. Usar un mapa de vectores simple, no Google Maps.
  • Tabla de datos: la pieza por defecto. Con opción de ordenar por columna.
  • Indicador de tendencia: flecha hacia arriba/abajo con color verde/rojo y porcentaje.
  • Nube de palabras: solo para análisis de texto.

Calendario (análisis 11)

  • Vista mensual: cabecera con año y mes, botones de navegación (<, >), fila de días de la semana, grilla de días.
  • Vista semanal: cabecera con semana, fila de días, eventos en columnas.
  • Vista diaria: cabecera con fecha, eventos en una lista.
  • Eventos: punto de 6 px del color de la entidad + texto corto. Al hacer clic, mostrar detalle.
  • Día actual: fondo circulo del acento al 10 %.
  • Crear evento: botón flotante o en la cabecera.

Panel de detalle (01, 02, 07)

  • Ancho fijo de 360 px.
  • Cabecera: título + ícono de cierre + botón de acción.
  • Cuerpo: secciones con rótulos de 12 px en texto-3, valores en tinta de 14 px. Con divide-y entre secciones.
  • Actividad: timeline vertical con puntos de color + texto + hora.
  • Archivos adjuntos: icono + nombre + tamaño.
  • Comentarios: avatar + nombre + texto + fecha. Con campo de entrada al final.

Estados vacío, cargando y error (6b · análisis 12)

  • Vacío: ilustración de 120 px + título de 18 px + descripción de 14 px + acción (botón). El tono es informativo, no de error.
  • Cargando: skeleton de 8 px de radio, fondo gris claro, animación de pulso. Para cada pieza de contenido (tarjeta, tabla, KPI).
  • Error: ilustración de 120 px + título de 18 px + descripción + botón de "Reintentar". El tono es de advertencia, no de pánico.
  • Sin conexión: banner en la parte superior del panel, fondo rojo claro, texto "Sin conexión. Los datos pueden estar desactualizados."

Móvil (celular) (análisis 13)

  • Breakpoint: 390 px.
  • Menú inferior: 48–56 px, con ícono + texto (corto). El activo es del acento.
  • Barra superior: 56 px, con menú hamburguesa + título + acciones (avatar, búsqueda).
  • Contenido: apilado vertical, sin grid. Las tarjetas KPI van en fila de 2 en pantallas de 390 px (con scroll horizontal opcional).
  • Tablas: scroll horizontal.
  • Formularios: campos a ancho completo.
  • Modal: pantalla completa.
  • Navegación: gestos de swipe para atrás.

6. Principios de diseño

  • Fricción cero: el usuario no tiene que esperar ni pensar. Las transiciones son instantáneas (~200 ms), las acciones están donde se esperan, los formularios se envían sin recarga.
  • Una acción principal por pantalla: no sobrecargar. Si hay varias acciones, priorizar y esconder las secundarias en un menú contextual.
  • Nada de textos de relleno: cada texto tiene un propósito. Los subtítulos llevan datos reales, los tooltips son informativos, los botones describen la acción ("Crear proyecto", no "Enviar").
  • Consistencia: el sistema se siente de la misma familia aunque cambie de acento. Las piezas, la tipografía, los radios, los espacios, los estados, los colores de datos... todo se hereda.
  • Accesibilidad: contraste mínimo de 4.5:1 para texto normal, 3:1 para grande. Navegación por teclado. Roles ARIA donde sea necesario. Soportar prefers-reduced-motion.
  • Rendimiento: el CSS y los assets deben ser ligeros. Sin animaciones que bloqueen el render. Carga lazy de imágenes.
  • Mobile-first: diseñar primero en móvil y luego escalar a escritorio. Probar en 390 px y en 1280 px.

7. Tokens (tokens.css)

El archivo tokens.css contiene los tokens de diseño. Nombres en español para que sean semánticos y se entiendan en el contexto del sistema. Los valores son ejemplos; cada sistema ajusta los suyos.

Los tokens se organizan en:

  • Color: --fondo, --panel, --superficie, --borde, --tinta, --texto-2, --texto-3, --acento, --verde, --ambar, --rojo, --azul, --gris, --dato-1 a --dato-6.
  • Tipografía: --font-display, --font-text, --font-mono, --text-xs a --text-4xl.
  • Espaciado: --spacing-xs a --spacing-4xl.
  • Radios: --radius-marco, --radius-panel, --radius-card, --radius-button, --radius-pill.
  • Sombras: --shadow-sm, --shadow-hover, --shadow-lg, --shadow-floating.
  • Breakpoints: --bp-sm, --bp-md, --bp-lg.

8. Lista de verificación final

Antes de dar por terminada una pantalla, pasar esta lista:

  1. ¿La barra lateral está sobre el lienzo?
  2. ¿El panel tiene radio 20 y está separado 8 px?
  3. ¿El menú activo es una pastilla bg-superficie
  4. ¿La cabecera tiene título display y subtítulo con cifras reales?
  5. ¿Hay un solo botón principal?
  6. ¿Los KPIs tienen dibujo y contexto?
  7. ¿Hay un protagonista (tarjeta llena de color)?
  8. ¿Las entidades tienen color por id?
  9. ¿Los gráficos tienen estado (sólido vs. rayado)?
  10. ¿Hay movimiento con propósito (cifras que cuentan, barras que crecen)?
  11. ¿Las tarjetas tienen borde de 1 px y sombra mínima?
  12. ¿Los radios están en capas (padre más redondeado que hijo)?
  13. ¿La tipografía usa display + texto + mono?
  14. ¿Las cifras tienen tabular-nums y el símbolo de moneda está en texto-3?
  15. ¿El acento se usa solo en un lugar?
  16. ¿Los estados son pastilla con fondo al 10 % + texto + punto?
  17. ¿La paleta de datos (máximo 6) solo aparece en gráficos y progreso?
  18. ¿Las tablas no tienen líneas verticales?
  19. ¿Los formularios tienen modo natural (campo por línea, rótulo arriba)?
  20. ¿El calendario tiene eventos como puntos de color?
  21. ¿El panel de detalle tiene 360 px y timeline vertical?
  22. ¿El estado vacío tiene ilustración + acción?
  23. ¿El estado de carga tiene skeleton con pulso?
  24. ¿El estado de error tiene botón de reintentar?
  25. ¿En móvil el menú es inferior?
  26. ¿Se probó en 390 px?
  27. ¿Se probó en oscuro?
  28. ¿Se respeta prefers-reduced-motion?
  29. ¿El contraste mínimo es 4.5:1?
  30. ¿Se contaron los colores? (grises + 1 acento + hasta 4 de estado + hasta 6 de datos)

9. Archivos de referencia

  • tokens.css: tokens de color, tipografía, espaciado, radios, sombras.
  • ejemplos/: ejemplos de pantallas completas y componentes.
  • referencias/: capturas de pantalla de referencia.
  • analisis/: análisis detallados por tema.
  • marcas.local.md: (opcional) reglas específicas de la marca.
  • recetas-tailwind.md: componentes en React + Tailwind v4.

10. Conclusión

Este sistema de diseño está hecho para ser adaptado a cada sistema y marca, manteniendo la coherencia visual y la experiencia de usuario. Los principios, tokens y ejemplos son la guía; cada sistema ajusta el acento y el tinte de los neutros. La meta es que el usuario sienta que está usando una herramienta profesional, premium y eficiente, sin fricción y con datos vivos en cada pantalla.

Skills associés