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 complejaReglas obligatorias
useState+useEffectpara fetching — no react-query (ver Dashboard).- Muestra un
<Skeleton>mientras carga. toast.error()en cadacatch.- Componentes de
@/components/ui/(shadcn/ui), iconos delucide-react. - Moneda:
Intl.NumberFormat('es-DO', { style: 'currency', currency: 'DOP' }). - Fechas con
date-fns+ localees. export default(no named export) para las páginas.
Después de crear la página
- Registra la ruta en
src/routes/index.tsx. - 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.