¿Qué hace Sistema de diseño?
Resumen
Un sistema de diseño es el lugar donde una decisión se toma una vez y luego se reutiliza en todas partes. Cada color es un token, cada elemento interactivo muestra todos sus estados y cada cambio llega a todas las pantallas que usan ese elemento. Constrúyelo por capas, primero los fundamentos, y detente para aprobar en cada capa. Una auditoría informa y nunca corrige por sí sola.
Cuándo usarlo
- "Iniciar una guía de estilos / sistema de diseño / tokens para …"
- Agregar un componente, variante o token, o modificar uno existente.
- "Hacer que estas pantallas sean coherentes", "estandarizar", "auditar la guía", o valores hex sueltos y elementos únicos en las pantallas.
Cuándo NO usarlo
- Una pregunta sobre un valor único ("¿cuál es nuestro color principal?"): respóndela.
- Una edición pequeña que la persona describió exactamente (un valor, una etiqueta, un tamaño), incluso en un elemento compartido: cámbialo una vez donde está definido y di qué pantallas afecta. Sin matriz de estados, sin parada.
Antes de empezar
- Lee
DESIGN.mden la raíz del proyecto si existe: es el resumen de diseño del proyecto. - Encuentra lo que existe: tokens, la guía, los componentes, las pantallas y el código. Una guía existente prevalece en el aspecto visual. Sigue sus reglas incluso si difieren de los valores predeterminados a continuación, y menciona la diferencia una vez.
- Elige el adaptador de tu herramienta en
references/adapters/(paper.md,figma.md,html.md). Si ningún adaptador coincide con tu herramienta, haz los mismos verbos en tu herramienta y di cuáles mapeaste manualmente. Sin ninguna herramienta de diseño, construye en HTML (html.md). Si solo tienes una imagen, di que los valores leídos de ella son estimaciones. - Decide el modo: crear, agregar o cambiar, o auditar.
Pasos · crear
-
Borrador de fundamentos:
- roles de color (roles de token);
- escala tipográfica;
- espaciado;
- radio;
- sombras (dos como máximo);
- anchos de diseño;
- duraciones de movimiento;
- una sección breve de "cómo escribimos".
Nombra los tokens por rol (
text-muted,border-hover,danger-bg), nunca solo por valor (gray-500). -
Reglas de interacción, una vez: para elementos con borde, elementos sin borde y la acción principal, escribe cómo se ven hover, presionado, foco (solo teclado), deshabilitado, carga y seleccionado. Los componentes siguen estas reglas en lugar de inventar las suyas propias.
-
Detente y muéstrale a la persona los fundamentos y las reglas de interacción. No construyas componentes todavía.
-
Componentes uno a la vez, en el orden que las primeras pantallas los necesitan. Cada uno obtiene una sección de guía con la anatomía del componente: una leyenda con la regla y el porqué, ejemplos y una matriz de estados de variantes × estados. Agrega cada uno al índice de componentes.
Pasos · agregar o cambiar una pieza
- Verifica si un componente existente más una variante cubre la necesidad. Prefiere la reutilización a un elemento único.
- Dibújalo con la anatomía, incluida la matriz de estados completa. Un nuevo color, tamaño o ícono se convierte en un token o una entrada del conjunto de íconos ahora, no después.
- Enumera cada pantalla y ubicación de código que usa la pieza.
- Detente y muéstrale a la persona el cambio y esa lista.
- Tras la aprobación, propaga:
- actualiza cada pantalla de la lista;
- actualiza el código, si lo hay;
- actualiza el índice de componentes;
- informa qué cambió y dónde.
Pasos · auditar
- Ejecuta la lista de verificación de auditoría sobre la guía, las pantallas y el código si lo hay.
- Redacta el informe: hallazgos clasificados por severidad, cada uno con dónde está, por qué es importante y la corrección propuesta.
- Detente y muéstrale a la persona el informe. No cambies ningún archivo hasta que digan qué correcciones hacer. Guardar copias de los originales no hace que editarlos sea aceptable.
Reglas
Firmes (cualquier proyecto):
| Regla | Por qué |
|---|---|
| Cada color es un token; sin valores hex sueltos en pantallas o código | Los valores sueltos derivan en casi-duplicados que nadie puede cambiar a la vez |
| Un solo conjunto de íconos | Los conjuntos mezclados parecen productos mezclados |
| El diseño y el código cambian juntos, primero el diseño | De lo contrario, la guía deja de ser la verdad en una semana |
| Cada elemento interactivo tiene una matriz de estados | Los estados dibujados ad hoc en las pantallas nunca coinciden |
| Un cambio en una pieza compartida se enumera con las pantallas que afecta antes de propagarse | De lo contrario, un cambio "pequeño" rediseña silenciosamente veinte pantallas |
Valores predeterminados (una guía existente los anula):
| Valor predeterminado | Por qué |
|---|---|
| Al pasar el ratón, los elementos con borde solo oscurecen el borde | Un fondo cambiante en tarjetas y campos se siente pesado |
| El hover es más sutil que el seleccionado | Cuando el hover parece seleccionado, la gente piensa que dos cosas están elegidas |
| Seleccionar nunca cambia el peso de la fuente | Un cambio de peso desplaza el ancho del texto |
| Los placeholders son más claros que el texto atenuado | De lo contrario, un placeholder se lee como texto ingresado |
| Los elementos en listas apiladas y menús tienen un pequeño espacio, nunca se tocan | Los toques de resaltado se fusionan en un solo bloque |
| El anillo de foco solo aparece desde el teclado | Un anillo después de un clic del ratón parece un error |
| La carga mantiene el tamaño exacto del elemento | Cambio de diseño |
| Sombras solo en elementos flotantes (menús, popovers, diálogos, toasts), con dos intensidades | Sombras en todas partes aplastan la jerarquía que debían crear |
| Como máximo una acción principal por pantalla | Dos acciones principales significa que la pantalla no decidió |
Hecho cuando
- Crear: fundamentos y reglas de interacción aprobados; cada componente tiene su anatomía, matriz de estados y una fila en el índice.
- Cambiar: cada pantalla y ubicación de código listada actualizada, y el índice actualizado.
- Auditar: un informe clasificado entregado y ningún archivo modificado.
Errores comunes
| Pensamiento | Realidad |
|---|---|
| "Construiré toda la guía de una vez: tokens y diez componentes" | Diez componentes sobre fundamentos no aprobados significa diez reelaboraciones. Fundamentos, parada, luego componentes. |
| "La auditoría encontró problemas, los corregiré directamente" | La persona puede estar en desacuerdo con la mitad de las correcciones. Informa, detente, corrige solo lo que elijan. |
| "Guardé los originales en una carpeta de respaldo, así que corregir es seguro" | Un respaldo no hace que la persona acepte las correcciones. Informa primero. |
| "Los botones tienen hover y deshabilitado, es suficiente" | Una matriz de estados tiene cada estado × cada variante: normal, hover, presionado, foco, deshabilitado, carga, seleccionado. |
"--teal-600 es un token" | Es un valor. Los componentes necesitan roles (--color-primary) para que el valor pueda cambiar en un solo lugar. |
| "Esta pantalla necesita una tarjeta ligeramente diferente" | Conviértelo en una variante de la tarjeta, o usa la tarjeta. Un elemento único es el comienzo de la desviación. |