UI de Línea Base
Impone una línea base UI opinada para evitar la generación de interfaces de baja calidad por parte de la IA.
Cómo usar
-
/baseline-uiAplica estas restricciones a cualquier trabajo de UI en esta conversación. -
/baseline-ui <archivo>Revisa el archivo contra todas las restricciones siguientes y genera como salida:- violaciones (cita la línea o fragmento exacto)
- por qué es importante (1 oración corta)
- una solución concreta (sugerencia a nivel de código)
Stack
- DEBE usar valores predeterminados de Tailwind CSS a menos que ya existan valores personalizados o se soliciten explícitamente
- DEBE usar
motion/react(anteriormenteframer-motion) cuando se requiera animación JavaScript - DEBERÍA usar
tw-animate-csspara animaciones de entrada y micro-animaciones en Tailwind CSS - DEBE usar la utilidad
cn(clsx+tailwind-merge) para la lógica de clases
Componentes
- DEBE usar primitivas de componentes accesibles para cualquier cosa con comportamiento de teclado o foco (
Base UI,React Aria,Radix) - DEBE usar primero las primitivas de componentes existentes del proyecto
- NUNCA mezclar sistemas de primitivas dentro de la misma superficie de interacción
- DEBERÍA preferir
Base UIpara nuevas primitivas si es compatible con el stack - DEBE agregar un
aria-labela los botones solo con icono - NUNCA reconstruir el comportamiento de teclado o foco manualmente a menos que se solicite explícitamente
Interacción
- DEBE usar un
AlertDialogpara acciones destructivas o irreversibles - DEBERÍA usar esqueletos estructurales para los estados de carga
- NUNCA usar
h-screen, usarh-dvh - DEBE respetar
safe-area-insetpara elementos fijos - DEBE mostrar los errores junto al lugar donde ocurre la acción
- NUNCA bloquear el pegado en elementos
inputotextarea
Animación
- NUNCA agregar animación a menos que se solicite explícitamente
- DEBE animar solo propiedades del compositor (
transform,opacity) - NUNCA animar propiedades de diseño (
width,height,top,left,margin,padding) - DEBERÍA evitar animar propiedades de pintura (
background,color) excepto para UI pequeña y local (texto, iconos) - DEBERÍA usar
ease-outen la entrada - NUNCA exceder
200mspara la retroalimentación de interacción - DEBE pausar las animaciones en bucle cuando están fuera de la pantalla
- DEBERÍA respetar
prefers-reduced-motion - NUNCA introducir curvas de easing personalizadas a menos que se solicite explícitamente
- DEBERÍA evitar animar imágenes grandes o superficies de pantalla completa
Tipografía
- DEBE usar
text-balancepara encabezados ytext-prettypara cuerpo/párrafos - DEBE usar
tabular-numspara datos - DEBERÍA usar
truncateoline-clamppara UI densa - NUNCA modificar
letter-spacing(tracking-*) a menos que se solicite explícitamente
Layout
- DEBE usar una escala fija de
z-index(sinz-*arbitrario) - DEBERÍA usar
size-*para elementos cuadrados en lugar dew-*+h-*
Rendimiento
- NUNCA animar superficies grandes con
blur()obackdrop-filter - NUNCA aplicar
will-changefuera de una animación activa - NUNCA usar
useEffectpara cualquier cosa que pueda expresarse como lógica de renderizado
Diseño
- NUNCA usar degradados a menos que se solicite explícitamente
- NUNCA usar degradados morados o multicolores
- NUNCA usar efectos de brillo como affordances primarios
- DEBERÍA usar la escala de sombras predeterminada de Tailwind CSS a menos que se solicite explícitamente
- DEBE dar a los estados vacíos una única acción clara a seguir
- DEBERÍA limitar el uso del color de acento a uno por vista
- DEBERÍA usar tokens de color del tema existente o de Tailwind CSS antes de introducir nuevos