Detalles que hacen que las interfaces se sientan mejor
Las grandes interfaces rara vez provienen de una sola cosa. Generalmente es una colección de pequeños detalles que se combinan para crear una gran experiencia. Aplica estos principios al construir o revisar código de UI.
Al revisar, ralentiza la interfaz: reproduce el movimiento al 10% de velocidad en el panel de Animaciones del navegador y recorre cada estado: hover, focus, active, loading, empty. Lo que se siente extraño al 10% de velocidad es lo que está sutilmente mal a velocidad normal.
Conserva la biblioteca de componentes, tokens y densidad del proyecto. Iguala su lenguaje de movimiento establecido, excepto cuando un principio a continuación prescriba un patrón de interacción exacto.
La tipografía (ajuste de texto, renderizado de fuentes, números tabulares, espaciado) está cubierta por el skill better-typography; úsalo para todo lo relacionado con texto. La accesibilidad (áreas de toque, estados de focus, soporte de teclado, ARIA, movimiento reducido) está cubierta por el skill better-accessibility. La estructura de diseño (agrupación, espaciado entre secciones, puntos de quiebre, RTL espacial) está cubierta por el skill better-layout.
Referencia Rápida
| Categoría | Cuándo Usar |
|---|---|
| Superficies | Radio de borde, alineación óptica, sombras, contornos de imagen |
| Animaciones | Animaciones interrumpibles, transiciones de entrada/salida, animaciones de iconos, escala al presionar, moderación de movimiento |
| Iconos | Grosor de trazo de iconos, estados mediante currentColor, contorno vs relleno, tamaño, volteo RTL |
| Rendimiento | Especificidad de transición, uso de will-change |
Principios Clave
1. Radio de Borde Concéntrico
Radio exterior = radio interior + relleno. Los radios desiguales en elementos anidados es lo más común que hace que las interfaces se sientan extrañas.
2. Alineación Óptica sobre Geométrica
Cuando la centración geométrica se ve mal, alinea ópticamente. Los botones con iconos, triángulos de reproducción e iconos asimétricos necesitan ajuste manual.
3. Sombras para Elevación, Bordes para Estructura
Para botones, tarjetas y contenedores cuyo borde existe solo para crear profundidad, prefiere valores de box-shadow transparentes superpuestos. Mantén los bordes que comunican estructura o estado: divisores, separadores de diseño y estados seleccionados o de focus.
4. Animaciones Interrumpibles
Usa transiciones CSS para cambios de estado interactivos: pueden interrumpirse a mitad de la animación. Reserva los keyframes para secuencias escenificadas que se ejecutan una sola vez.
5. Dividir y Escalonar Animaciones de Entrada
Para una entrada escenificada poco frecuente donde la secuencia ayuda a comunicar jerarquía, divide el contenido en fragmentos semánticos y escalónalos por ~100ms en lugar de animar un solo contenedor. No escalones interacciones rutinarias de alta frecuencia.
6. Animaciones de Salida Sutiles
Usa un pequeño translateY fijo en lugar de altura completa. Las salidas deben ser más suaves que las entradas. Usa ease-out tanto para transiciones de entrada como de salida.
7. Animaciones de Iconos Contextuales
Anima iconos con opacity, scale y blur en lugar de alternar visibilidad. Usa exactamente estos valores: escala de 0.25 a 1, opacidad de 0 a 1, desenfoque de 4px a 0px. Si el proyecto tiene motion o framer-motion en package.json, usa la ruta de importación de ese paquete (o las importaciones cercanas establecidas cuando ambos existan) y usa transition: { type: "spring", duration: 0.3, bounce: 0 }; bounce siempre debe ser 0. Si no hay ninguna biblioteca de movimiento instalada, mantén ambos iconos en el DOM (uno con posicionamiento absoluto) y haz una transición cruzada con transiciones CSS usando cubic-bezier(0.2, 0, 0, 1); esto proporciona animaciones de entrada y salida sin ninguna dependencia.
8. Contornos de Imagen
Agrega un contorno sutil de 1px con baja opacidad a las imágenes para una profundidad consistente. El color debe ser negro puro en modo claro (oklch(0 0 0 / 0.1)) y blanco puro en modo oscuro (oklch(1 0 0 / 0.1)), nunca un negro cercano como pizarra, zinc o cualquier neutro teñido. Un contorno teñido absorbe el color de la superficie subyacente y se ve como suciedad en el borde de la imagen.
9. Escala al Presionar
Un sutil scale(0.96) al hacer clic proporciona retroalimentación táctil a los botones. Usa siempre 0.96. Nunca uses un valor menor a 0.95: cualquier valor inferior se siente exagerado. Agrega una prop static para deshabilitarlo cuando el movimiento pueda distraer.
10. Saltar Animación al Cargar la Página
Usa initial={false} en AnimatePresence para evitar animaciones de entrada en el primer renderizado. Verifica que no rompa las animaciones de entrada intencionales.
11. Nunca Usar transition: all
Especifica siempre propiedades exactas: transition-property: scale, opacity. La clase transition-transform de Tailwind cubre transform, translate, scale, rotate.
12. Usar will-change con Moderación
Solo para transform, opacity, filter, las propiedades que la GPU puede componer. Nunca uses will-change: all. Agrégala solo cuando notes tartamudeo en el primer fotograma.
13. Igualar el Grosor del Trazo del Icono al Peso del Texto
Un icono junto al texto carga el peso óptico del texto: trazo de 1.5px junto a texto regular (400), trazo de 2px junto a texto seminegrita (600). Un grosor de trazo por conjunto de iconos; nunca mezcles bibliotecas en una misma superficie.
14. Un Solo SVG, Recoloreado por Estado
Los iconos usan currentColor y obtienen sus estados (hover, selected, disabled) del color y opacidad de CSS, nunca de activos separados. La variante de contorno es la predeterminada; la variante de relleno marca el estado activo.
15. Moderación de Movimiento
Sin animación personalizada en interacciones de alta frecuencia: el costo de atención se repite en cada desencadenante. El movimiento nunca es el único canal de retroalimentación; cada cambio de estado animado también necesita una señal estática (color, icono, etiqueta).
Errores Comunes
| Error | Solución |
|---|---|
| Mismo radio de borde en padre e hijo muy anidados | Calcula radioExterior = radioInterior + relleno |
| Los iconos se ven descentrados | Ajusta ópticamente con relleno o corrige el SVG directamente |
| Borde usado solo para simular elevación | Usa box-shadow superpuestos con transparencia; mantén bordes estructurales y de estado |
| Entrada escenificada brusca o salida contextual | Escalona entradas poco frecuentes y mantén sutiles las salidas que preservan el contexto |
| Icono con estado o alternador anima su estado predeterminado al cargar la página | Agrega initial={false} a ese AnimatePresence; preserva las entradas de página intencionales |
transition: all en elementos | Especifica propiedades exactas |
| Tartamudeo de animación en el primer fotograma | Agrega will-change: transform (con moderación) |
| Icono de línea fina junto a texto en negrita | Iguala el ancho del trazo al peso del texto |
| Activos de icono separados por estado | Un SVG con currentColor, estados mediante CSS |
| Iconos rellenos en todas partes | Contorno como predeterminado, relleno solo para el estado activo |
| Animación de entrada en cada hover o pulsación de tecla | Retroalimentación instantánea o transición de opacidad/color de ≤150ms |
Formato de Salida de Revisión
Usa este formato solo cuando el usuario solicite una revisión independiente de pulido de UI. Cuando better-interface orqueste la revisión, proporciona evidencia del dominio y hallazgos a ese skill y deja que su formato de salida, escala de severidad, reglas de consolidación, límite y veredicto tengan prioridad.
Presenta la revisión independiente en dos partes.
Hallazgos
Agrupa todos los hallazgos confirmados por principio. Usa una tabla de markdown con las columnas Severidad, Ubicación, Antes, Después y Por qué. Nunca uses líneas separadas "Antes:" / "Después:".
- Severidad:
HIGHhace que una interacción sea engañosa, no responda o sea repetidamente disruptiva;MEDIUMcrea un problema notable de calidad o consistencia;LOWes pulido aislado. - Ubicación: cita
ruta/al/archivo:línea. Si el artefacto no tiene archivos fuente, cita la pantalla y el componente exactos. - Antes / Después: muestra la implementación actual y un reemplazo accionable.
- Por qué: menciona el principio violado y explica cómo afecta a la interfaz.
Consolida un problema sistémico repetido en una sola fila y lista cada ubicación afectada. Omite principios sin hallazgos.
Ejemplo
Radio de borde concéntrico
| Severidad | Ubicación | Antes | Después | Por qué |
|---|---|---|---|---|
| LOW | src/Card.tsx:28 | rounded-xl en tarjeta + rounded-xl en botón interno (p-2) | rounded-2xl en tarjeta (8 + 8 = 16), rounded-lg en botón interno | Las esquinas anidadas deben ser concéntricas |
| LOW | src/card.css:11 | border-radius: 16px en ambas superficies anidadas | Exterior 24px, interior 16px con relleno de 8px | Radios anidados iguales hacen que la superficie interior se vea apretada |
Escala al presionar
| Severidad | Ubicación | Antes | Después | Por qué |
|---|---|---|---|---|
| LOW | src/Button.tsx:19 | <button className="..."> | Agregar active:scale-[0.96] transition-transform | La retroalimentación de presión hace que el control se sienta receptivo |
| MEDIUM | src/button.css:24 | scale(0.9) al presionar | Elevar a scale(0.96) | Cualquier valor por debajo de 0.95 se siente exagerado |
Verificación y Veredicto
Después de los hallazgos:
- Verificación: enumera las comprobaciones exactas realizadas y sus resultados observados. Recorre cada estado relevante e inspecciona el movimiento al 10% de velocidad cuando haya animación involucrada. Si no se realizó una comprobación, indica qué aún necesita verificación.
- Veredicto:
Bloquearsi queda algún hallazgoHIGH,Requiere cambiossi solo quedan hallazgosMEDIUMoLOW, yAprobarsolo cuando no queden hallazgos accionables.
Cuando no haya hallazgos, omite las tablas, indica "Sin hallazgos accionables de pulido de UI", informa la verificación y termina con Aprobar.