ValwispDocs
DesarrolladoresGuías

Añadir una página al dashboard

Estructura y reglas obligatorias para crear una página nueva en valwisp-dashboard.

Referencias según el tipo de página

  • Lista paginada → src/features/isp/clientes/index.tsx
  • Dashboard con cards → src/features/isp/dashboard/index.tsx
  • Cards de estado → src/features/isp/routers/index.tsx

Estructura

src/features/isp/[nombre]/
  index.tsx             → export default function [Nombre]Page()
  components/           → componentes locales, si hacen falta
  hooks/use[Nombre].ts   → hook de datos, si la lógica es compleja

Reglas obligatorias

  • useState + useEffect para fetching — no react-query (ver Dashboard).
  • Muestra un <Skeleton> mientras carga.
  • toast.error() en cada catch.
  • Componentes de @/components/ui/ (shadcn/ui), iconos de lucide-react.
  • Moneda: Intl.NumberFormat('es-DO', { style: 'currency', currency: 'DOP' }).
  • Fechas con date-fns + locale es.
  • export default (no named export) para las páginas.

Después de crear la página

  1. Registra la ruta en src/routes/index.tsx.
  2. Agrega el item al menú en src/components/layout/AppSidebar.tsx — recuerda que el sidebar filtra por permiso (modules: [...]), así que la página no aparecerá para roles sin el permiso correspondiente. Si el permiso todavía no existe, ver Agregar un permiso al catálogo.

On this page