Refactorización de la UI
El diseño visual no es talento. Es un pequeño conjunto de decisiones de sistemas tomadas una vez, más un puñado de técnicas para crear jerarquía. Esta habilidad son esos sistemas y esas técnicas.
La causa principal de una UI con aspecto amateur es elegir valores sobre la marcha — 17px aquí, #3B82F6 allá, lighten(5%) para un estado hover. Diseña desde una escala, siempre.
Los sistemas — úsalos, no los reinventes
Elige de estas listas. Nunca inventes un valor que no esté en una.
Espaciado y tamaño
Base 16px, construida a partir de factores y múltiplos:
4 8 12 16 24 32 48 64 96 128 192 256 384 512 640 768
Apretado en el extremo pequeño, expandiéndose en el grande. No puede haber dos valores adyacentes con menos del ~25% de diferencia — eso es lo que hace obvia la elección. Una escala lineal de "múltiplos de 4" falla: no te ayuda a decidir entre 120px y 124px.
Úsalo para márgenes, padding, ancho, alto, tamaños de iconos, grosor de bordes — todo lo espacial. Fija también un pequeño conjunto de valores de opacidad (ej. .05 .1 .2 .4 .6 .8) para estados deshabilitados, superposiciones y tintes hover, en lugar de ajustar un control deslizante cada vez. Misma lógica que las otras escalas: decide una vez, reutiliza en todas partes.
Escala tipográfica
12 14 16 18 20 24 30 36 48 60 72
No una escala modular construida a partir de una proporción (4:5, 2:3, proporción áurea). Esas producen valores fraccionarios de píxeles que se redondean de manera inconsistente entre navegadores y son demasiado dispersos para la densidad de la interfaz. En su lugar, ganan los valores elegidos manualmente, seleccionados por cómo se sienten.
Unidades: solo px o rem. Nunca em. em es relativo al tamaño de fuente actual, por lo que un .875em dentro de un padre 1.25em se calcula como 17.5px — un valor que no está en tu escala. La escala deja de existir silenciosamente.
Grosor de fuente
Dos grosores son suficientes:
- 400 o 500 — cuerpo y la mayoría del texto de UI
- 600 o 700 — cualquier cosa enfatizada
Nada por debajo de 400 en la UI. Para desenfatizar, usa un color más claro o un tamaño más pequeño — nunca un grosor más ligero.
Color
Necesitas muchos más colores de los que te da un generador de paletas de cinco muestras.
- Grises: 8–10 tonos. Casi toda la UI es gris — texto, fondos, paneles, bordes, controles de formulario. Tres o cuatro tonos siempre se quedan cortos. Empieza con un gris muy oscuro, no negro verdadero (el negro verdadero se ve antinatural).
- Primario: 5–10 tonos, uno o quizás dos primarios.
- Acentos: 5–10 tonos cada uno — rojo destructivo, amarillo de advertencia, verde positivo, más lo que sea que el producto necesite distinguir (series de gráficos, eventos de calendario, etiquetas). Diez colores × 5–10 tonos es normal para una UI compleja.
Nómbralos 100 (el más claro) → 900 (el más oscuro), base 500.
Construye la escala en este orden: elige 500 primero (para un primario/acento, debe ser un tono que funcione como fondo de botón). Luego encuentra los extremos — 900 suele ser tu color de texto, 100 un tinte de fondo; un componente de alerta usa ambos, así que diseña uno y lee los dos valores de él. Luego llena 700 y 300 como el compromiso perfecto entre sus vecinos, luego 800 600 400 200 de la misma manera.
Escribe los colores como HSL, no hex. hsl(220, 95%, 34%) y hsl(220, 65%, 61%) están visiblemente relacionados; #03369E y #507DD7 no.
Nunca generes tonos en tiempo de ejecución con lighten() / darken(). Así es como terminas con 35 azules ligeramente diferentes.
Sombras — cinco elevaciones
0 1px 3px hsla(0,0%,0%,.2) /* ligeramente elevado — botones */
0 4px 6px hsla(0,0%,0%,.2) /* menús desplegables */
0 5px 15px hsla(0,0%,0%,.2)
0 10px 24px hsla(0,0%,0%,.2)
0 15px 35px hsla(0,0%,0%,.2) /* modales */
Elige preguntándote ¿dónde en el eje z se sitúa esto?, no ¿qué sombra se ve bien?. Cuanto más cerca del usuario = más atención. Reducir la sombra de un botón en :active lo hace sentir presionado; agrandar la sombra de un elemento de lista cuando se levanta para arrastrar y reordenar hace lo contrario — se lee como "ahora por encima de sus hermanos" y duplica como el propio indicador de arrastre.
Estas cinco son el valor predeterminado y están bien en todas partes. references/techniques.md proporciona una versión de dos partes refinada de la misma escala — paralela, pero no con valores idénticos (su paso superior es más pesado). Úsala cuando las sombras sean prominentes en el diseño; usa estas cuando no lo sean. No mezcles las dos en un mismo proyecto.
Altura de línea y ancho de línea
La altura de línea es inversamente proporcional al tamaño de fuente, y proporcional al ancho de línea:
- texto pequeño / columnas anchas →
1.5a2 - titulares grandes →
1está bien
Ancho de línea: 45–75 caracteres, es decir, max-width: 20em–35em. Esto se aplica al párrafo incluso cuando el contenedor a su alrededor es más ancho — los anchos mixtos en un área de contenido se ven más pulidos, no menos.
(em es correcto aquí — la medida debe escalar con el texto que envuelve. La regla "nunca em" está limitada a la escala tipográfica, donde em se compone a través del anidamiento. No "corrijas" esto).
Radio de borde
Elige uno y mantente consistente. Radio pequeño = neutral. Radio grande = divertido. Ninguno = serio/formal. Mezclar esquinas cuadradas y redondeadas en una misma interfaz siempre se ve peor.
El procedimiento
1. Empieza con una funcionalidad, no con un diseño. No diseñes "la app" — no puedes decidir entre navegación superior y barra lateral antes de saber qué hay en el producto. Diseña una funcionalidad real (el formulario de búsqueda, el compositor de mensajes) y deja que la estructura emerja.
2. Los detalles vienen después. Ignora tipos de letra, sombras e iconos al principio. Trabaja primero en escala de grises — esto obliga a que la jerarquía provenga del espaciado, el contraste y el tamaño, en lugar del color. Añade color una vez que el diseño funcione.
3. No inviertas demasiado en baja fidelidad. Los bocetos, wireframes y maquetas son desechables — nadie puede usar una imagen estática de una aplicación. Existen para explorar ideas; abandónalos una vez que se haya tomado la decisión y ve a construir lo real.
4. Diseña la versión útil más pequeña, luego constrúyela. Trabaja en ciclos cortos de diseño→código. No impliques funcionalidad que no estés listo para construir — un cuadro de comentarios con una zona de archivos adjuntos que aún no puedes enviar bloquea toda la funcionalidad. Las mejoras se diseñan después.
5. Elige por eliminación. Al seleccionar un valor de una escala: adivina el que crees que es correcto, luego compáralo con el vecino de cada lado. Dos serán obviamente incorrectos. Si gana una opción exterior, repite la comparación con esa como el nuevo medio.
6. Empieza con demasiado espacio en blanco y luego elimínalo. Añadir espacio hasta que algo deje de verse mal te da el mínimo. Empezar generoso y recortar te da la cantidad correcta. Las UIs densas (paneles de control) son legítimas, pero como una decisión deliberada, no como un valor predeterminado.
7. Reduce el lienzo. Un componente pequeño diseñado en una mesa de trabajo de 1400px tiende a expandirse, porque el espacio está ahí para llenarse. Empieza a ~400px y diseña primero el diseño móvil, donde las restricciones son reales — luego llévalo a una pantalla grande y relaja solo lo que realmente se sintió apretado. Cambiarás menos de lo que esperas.
Jerarquía — la técnica que hace la mayor parte del trabajo
Todo en la pantalla se sienta en una pirámide: primario, secundario, terciario. Cuando todo compite, la UI se lee como ruido. Esto es lo que hace que un diseño se vea "diseñado" — no el estilo.
El tamaño no lo es todo. Apoyarse solo en el tamaño de fuente te da contenido primario que es demasiado grande y contenido secundario que es demasiado pequeño. Usa grosor y color para llevar el énfasis, y mantén los tamaños razonables.
Tres colores de texto, como máximo:
- oscuro — contenido primario
- gris — contenido secundario
- gris más claro — contenido terciario (notas al pie, derechos de autor)
Los tres llevan texto de tamaño corporal real, por lo que todos necesitan 4.5:1. "Gris más claro" significa el tono más claro que aún lo supera — aproximadamente la mitad de una rampa de 9 pasos, no el extremo pálido. Los tonos pálidos son solo para estados deshabilitados y texto grande.
Enfatiza desenfatizando. Cuando el elemento importante no destaque y no quede nada más que añadirle, suaviza lo que compite con él. Atenúa los elementos de navegación inactivos; reduce el color de fondo de la barra lateral para que el contenido principal se sitúe al frente.
Acciones: estiliza por jerarquía, no por semántica.
- Primaria → sólida, alto contraste. Generalmente solo una por página.
- Secundaria → contorno, o un fondo de bajo contraste.
- Terciaria → estilizada como un enlace.
Destructivo ≠ botón rojo grande. Si "Eliminar" no es la acción principal en la página, dale tratamiento terciario — luego hazlo un botón primario grande y rojo dentro del diálogo de confirmación, donde genuinamente es la acción principal.
Las etiquetas son un último recurso. etiqueta: valor da a cada pieza de datos el mismo peso. La mayoría de los datos se identifican por formato ($19.99, una dirección de correo electrónico) o por contexto. Cuando una etiqueta es realmente necesaria, intégrala en el valor ("Quedan 12 en stock", no "En stock: 12"), o añádela como contenido visiblemente secundario. Excepción: en páginas tipo ficha técnica donde los usuarios escanean la etiqueta, enfatiza la etiqueta en su lugar.
Equilibra el peso contra el contraste. Los iconos sólidos son visualmente pesados y eclipsarán el texto a su lado — suaviza su color para compensar. También funciona al revés: cuando un borde de 1px es demasiado sutil en un color suave pero demasiado fuerte una vez que lo oscureces, mantén el color suave y ve a 2px. Añade peso para arreglar bajo contraste; reduce contraste para arreglar exceso de peso.
Jerarquía visual ≠ jerarquía documental. El marcado semántico y el peso visual son decisiones separadas. Los títulos de sección suelen ser etiquetas, no titulares — un h1 a 16px está bien, y a veces el título debe ocultarse visualmente por completo porque el contenido habla por sí mismo.
Reglas estrictas
Desviarse de estas produce un fracaso específico y reconocible.
- Nunca texto gris sobre un fondo de color. El gris sobre blanco funciona porque reduce el contraste; el gris sobre color solo se ve sucio. El blanco con opacidad reducida se ve deslavado y deshabilitado, y deja ver patrones a través de los glifos. Elige manualmente un color con el tono del fondo, ajustando saturación y luminosidad.
- Nunca uses
empara la escala tipográfica. Usapxorem. - Nunca generes tonos en tiempo de ejecución. Defínelos de antemano.
- Nunca uses un ancho porcentual para algo que no debería escalar. Las barras laterales obtienen anchos fijos; el área principal se flexiona. Los elementos obtienen un
max-widthy solo se encogen cuando la pantalla es realmente más pequeña — una tarjeta de inicio de sesión no debería ser más ancha en pantallas medianas que en grandes. - Nunca escales cosas proporcionalmente entre puntos de interrupción. Los elementos grandes deben encogerse más rápido que los pequeños. Un titular de 2.5em sobre un texto de cuerpo móvil de 14px se calcula como 35px — demasiado grande; debería ser de 20–24px allí. Asimismo, el padding de un botón debería volverse proporcionalmente más ajustado a medida que el botón se encoge, no escalar con su tamaño de fuente.
- Siempre más espacio alrededor de un grupo que dentro de él. Esta es la solución para "¿qué etiqueta pertenece a qué campo?", listas con viñetas apretadas y encabezados que parecen adjuntos al párrafo equivocado. El espaciado ambiguo es un error funcional, no solo estético.
- Nunca uses el color como única señal. Añade un icono, una forma o una pista de texto. Para gráficos, distingue las series por contraste (tonos claros→oscuros de un color) en lugar de por tono — los usuarios daltónicos leen la luminosidad de manera fiable, el tono no tanto.
- Mínimos de contraste: 4.5:1 para texto normal. La tolerancia de 3:1 se aplica solo a texto grande, que WCAG define como 24px regular o 18.66px negrita — no 18px. Asume 4.5:1 a menos que el texto sea genuinamente tan grande. Cuando el blanco sobre color falla, inviértelo: texto de color oscuro sobre un tinte de color claro (consulta
references/systems.md). Por separado, 3:1 se aplica a no texto también (WCAG 1.4.11): si un borde es lo único que identifica un control — un contorno de input, un borde de casilla de verificación — necesita 3:1 contra su fondo. Una línea fina que solo divide contenido no. Son dos tokens diferentes, no uno. - Nunca escales un icono lejos de su tamaño previsto. Un icono de 16–24px a 48px se ve voluminoso y falto de detalles. En su lugar, colócalo dentro de un círculo de color.
Referencias
assets/tokens.css — un conjunto inicial completo y verificado de contraste de todo lo anterior como propiedades personalizadas CSS: espaciado, tipo, grosores, ancho de borde, una escala de opacidad fija, una rampa de gris frío de 9 tonos, un primario de 9 tonos, tres tríos de acentos, cinco elevaciones, una capa de rol semántico (--surface, --text-primary, --action…) y un bloque de modo oscuro que sobrescribe solo esos roles. Cópialo y reajusta los tonos en lugar de rederivar las escalas a partir de esta prosa. Referencia los roles en los componentes, no las rampas brutas — eso es lo que hace que el modo oscuro funcione. Cada par texto/superficie está verificado ≥4.5:1 en ambos modos y cada borde funcional ≥3:1; los tonos deliberadamente por debajo del umbral (deshabilitados, divisores decorativos, el paso solo para texto grande) están exentos por criterio y comentados en línea.
Carga estas cuando el trabajo lo requiera:
references/systems.md— construir una paleta desde cero: elegir el color base, mantener la saturación viva en los extremos claros y oscuros, rotación de tono, grises cálidos/fríos, y las dos válvulas de escape para alcanzar relaciones de contraste sin colores feos.references/diagnose.md— tabla de síntoma → solución. Cárgala primero cada vez que la tarea sea mejorar una UI existente en lugar de construir una nueva.references/techniques.md— simulación de profundidad y luz, sombras de dos partes, alineación de línea base, interletrado, salir de las formas de componentes predeterminadas y manejar imágenes subidas por el usuario.