Habilidad de Creación de Componentes UI
shadcn/ui + Patrones de Sistema de Diseño
Cuándo Usar: Al crear nuevos componentes de interfaz de usuario
CRÍTICO: Leer el Sistema de Diseño Primero
ANTES de generar cualquier UI: Lee /DESIGN-SYSTEM.md
Puerta de Calidad: Mínimo 9/10 en:
- Distintividad visual
- Alineación con la marca
- Accesibilidad
Patrón: Componente shadcn/ui
'use client';
import { Card } from '@/components/ui/card';
import { Button } from '@/components/ui/button';
export function MyComponent({ data }: { data: any }) {
return (
<Card className="p-6 border-border-subtle bg-bg-card">
<h2 className="text-xl font-semibold text-text-primary mb-4">
{data.title}
</h2>
<p className="text-text-secondary mb-4">
{data.description}
</p>
<Button variant="default" className="bg-accent-500 hover:bg-accent-600">
Acción
</Button>
</Card>
);
}
Tokens de Diseño (Obligatorios)
Usa estos, no valores en bruto:
Colores:
bg-bg-card(nobg-white)text-text-primary(notext-gray-900)accent-500(#ff6b35 naranja)border-border-subtle
Espaciado:
- Clases de Tailwind (p-4, mb-6, etc.)
Patrones Prohibidos
❌ bg-white (usa bg-bg-card)
❌ text-gray-600 (usa text-text-secondary)
❌ grid grid-cols-3 gap-4 sin responsive (agrega md:, lg:)
Patrones Obligatorios
✅ Tokens de diseño del sistema ✅ Todos los estados (hover, focus, disabled) ✅ Puntos de ruptura responsive ✅ Accesibilidad (aria-labels)
Estándar: Usa tokens de diseño, implementa todos los estados, garantiza accesibilidad