Diseño de UI: reglas para construir interfaces
Estas reglas están extraídas de UI Design Principles de Michael Filipiuk (edición 2021). Este archivo contiene las reglas que se aplican a cada pantalla. references/ (junto a este archivo) contiene los detalles, un archivo por tema; lee solo los archivos que tu tarea toque.
Las reglas sin etiqueta provienen del libro. (WCAG) marca un estándar de accesibilidad que el libro no menciona. (convention) marca un valor común de la industria añadido para cubrir un vacío. (derived) marca un valor calculado con el método propio del libro. 1 pt en el libro = 1 CSS px = 1 iOS pt = 1 Android dp.
El sistema de diseño del repositorio es el que manda
Si el repositorio ya tiene tokens o un tema (una configuración de Tailwind, variables CSS, un tema de shadcn/MUI, una librería components/ui/), úsalos. Esta habilidad solo llena lo que ellos no definen.
- Nunca introduzcas un segundo conjunto de tokens junto a los del repositorio.
- Reutiliza un componente existente en lugar de construir uno paralelo.
- Cuando el propio repositorio rompa una de las reglas siguientes (un contraste que falla, un botón de 32 px), mantén el valor del repositorio e informa del conflicto. No lo sobrescribas en silencio.
Prioridad cuando las reglas entren en conflicto: usabilidad > accesibilidad > consistencia > simplicidad > aspecto.
Ruta rápida
- Personalidad primero: divertida, neutral o seria, según la marca y la audiencia (
references/personality-and-copy.md). Nunca tu propio gusto. - Tokens antes que pantallas: colores, escala tipográfica y escala de espaciado, del repositorio o de
references/tokens.md. No uses nada fuera de ellos. - Escala de grises primero: consigue jerarquía, disposición y espaciado correctos, luego añade color solo donde tenga un propósito.
- Componentes con todos los estados (por defecto, hover, presionado, foco, deshabilitado, error, éxito), y todos los estados de la pantalla (vacío, cargando, error, 404).
- Antes de reportar como terminado: repasa
references/checklist.mdpara lo que hayas construido. Si puedes capturarlo en pantalla, revisa la captura, no el código.
Innegociables
- El espaciado viene de la escala. Usa una escala de 4 pt en móvil y una escala de 8 pt en web. Nada de valores 5, 13 o 22 px.
- El texto del cuerpo es de 16–17 px. Nunca bajes de 10 px para ningún texto, y prefiere 12 px o más. Nunca uses un peso Light en texto pequeño.
- Una sola tipografía, una sans serif por defecto. Usa alrededor de 5 tamaños.
- Nunca uses
#000000para texto o sombras. Usa un gris oscuro entintado como#1F1F1F. - Un solo color primario, aplicado solo a lo que debe destacar. Si todo destaca, nada destaca.
- Contraste: 4.5:1 para texto del cuerpo, y 3:1 para texto grande y partes de la interfaz (WCAG).
- Nunca uses solo el color para transmitir significado. Los errores, mensajes de éxito y enlaces también reciben un icono, texto, peso o un subrayado.
- Cada objetivo de toque o clic es de al menos 44×44, incluso cuando el glifo visible sea más pequeño.
- Los botones miden 40–60 px de alto, con un botón primario por grupo. Cuando los botones vienen en pares, el primario va a la derecha. La etiqueta dice exactamente lo que ocurre.
- Los inputs siempre tienen una etiqueta visible. Un placeholder solo no es una etiqueta. Usa un formulario de una sola columna con validación inline, y nunca borres lo que el usuario introdujo.
- Las sombras son suaves (desplazamiento Y grande, desenfoque grande, opacidad del 5–10%), y solo en elementos interactivos o elevados.
- Los iconos vienen de un mismo pack, con un solo estilo, el mismo grosor de trazo y el mismo redondeo. Los iconos que no sean universalmente conocidos llevan una etiqueta.
- Las animaciones dan retroalimentación, duran menos de 1000 ms y tienen easing (nunca lineales).
- Nada de Lorem Ipsum. Escribe texto real, breve y humano. Los errores dicen cómo solucionar el problema. Los diálogos nombran el objeto y la consecuencia.
- Lo mismo, mismo aspecto, mismo comportamiento en todas las pantallas. Sigue los patrones de la plataforma para el comportamiento.
Qué referencia leer
| La tarea toca | Leer |
|---|---|
| Un proyecto o tema nuevo, elegir valores | tokens.md (espaciado, escala tipográfica, roles de color, radio, sombra, movimiento, CSS inicial) |
| Una página o disposición de pantalla, cuadrícula, espaciado, jerarquía | layout.md |
| Estilos de texto, encabezados, párrafos | typography.md |
| Paleta, modo oscuro, sombras, degradados | color-and-depth.md |
| Botones y CTAs | buttons.md |
| Formularios, inputs, selects, checkboxes, validación | forms.md |
| Tarjetas, listas de elementos | cards.md |
| Iconos | icons.md |
| Barra de pestañas, navegación superior, barra lateral, enlaces | navigation.md |
| Fotos, ilustraciones, arte de estado vacío y 404 | imagery.md |
| Sensación de marca, etiquetas de botones, diálogos, errores, tono | personality-and-copy.md |
| Transiciones, hover, carga, retroalimentación | motion.md |
| Contraste, texto alternativo, objetivos, subtítulos | accessibility.md |
| Componentes para reutilizar, estados, pantallas vacías/404, un sistema de diseño | system-and-states.md |
| Revisar una pantalla terminada | checklist.md |
Todas las rutas están bajo la carpeta references/ de esta habilidad.