Diseño de Panel de Control
Reglas
- Diseño de barra lateral + contenido principal: barra lateral fija (w-64), área principal fluida con relleno
- Navegación en barra lateral: enlaces de icono + etiqueta, resaltado de estado activo, colapsable en móvil
- Fila de tarjetas KPI en la parte superior: 3-4 tarjetas en una cuadrícula responsiva — nombre de métrica, valor, tendencia (subida/bajada %), gráfico de chispa opcional
- Tablas de datos: columnas ordenables, filtrables por búsqueda/estado, paginadas (10-25 filas por defecto)
- Usa
@tanstack/react-table para la lógica de tabla sin interfaz — combínalo con los componentes Table de shadcn/ui
- Responsivo: la barra lateral se colapsa a menú de hamburguesa en el punto de interrupción
md, las tarjetas se apilan a 1-2 columnas
- Estados de carga: marcadores de posición de esqueleto que coinciden con las formas de tarjetas/tablas — nunca cambio de diseño
- Selector de rango de fechas para filtrar los datos del panel — por defecto, últimos 30 días
Estructura del Diseño
┌──────────┬────────────────────────────┐
│ Sidebar │ Header / Breadcrumbs │
│ ├────────────────────────────┤
│ Nav │ KPI Cards (3-4 grid) │
│ Links ├────────────────────────────┤
│ │ Charts / Graphs │
│ ├────────────────────────────┤
│ │ Data Table │
└──────────┴────────────────────────────┘
Patrones
function KPICard({ title, value, change }: { title: string; value: string; change: number }) {
return (
<Card>
<CardHeader className="pb-2">
<CardTitle className="text-sm font-medium text-muted-foreground">{title}</CardTitle>
</CardHeader>
<CardContent>
<div className="text-2xl font-bold">{value}</div>
<p className={cn("text-xs", change >= 0 ? "text-green-600" : "text-red-600")}>
{change >= 0 ? "+" : ""}{change}% desde el período anterior
</p>
</CardContent>
</Card>
);
}
Evitar
- Contenido principal de ancho fijo — usa siempre diseño fluido que ocupe el espacio disponible
- Tablas sin paginación — los conjuntos de datos grandes perjudican el rendimiento y la usabilidad
- Estados de carga/vacío faltantes — muestra siempre esqueletos o mensajes de "Sin datos"
- Barra lateral que no se puede colapsar — los usuarios móviles necesitan el ancho completo de la ventana
- Spinners de carga para actualizaciones parciales de página — usa esqueletos para secciones específicas
- Amontonar demasiados KPI — resalta 3-5 métricas críticas, coloca el resto en secciones expandibles
- Barra lateral personalizada desde cero — usa el componente sidebar de shadcn
- Estados vacíos sin acciones — incluye siempre una CTA ("Aún no hay campañas. Crea la primera →")