kiranism-shadcn-dashboard

What problem does it solve?

This guide codifies the exact patterns and conventions for building and extending a Next.js 16 + shadcn/ui admin dashboard so engineers can add pages, feature modules, tables, forms, themes, and RBAC-enabled navigation without breaking project conventions or creating integration bugs.

Core Features & Use Cases

• Page & Routing Patterns: Standardized locations and patterns for new pages under src/app/dashboard with server-side prefetch, HydrationBoundary, and Suspense-friendly client components.
• Feature Module Structure: Co-located api (types → service → queries → mutations), Zod schemas, components, and mock-api data to implement listing, detail, create, and edit flows.
• Tables & Forms: Data tables using useSuspenseQuery, DataTable patterns, and cell actions; forms built with TanStack Form + Zod including page and sheet variants.
• Theming, Icons & Navigation: Theme CSS, theme registration, icon registry rules, and nav-config/RBAC conventions for Clerk orgs, permissions, and plan gating.
• Query & Mutation Best Practices: queryOptions/mutationOptions abstractions, getQueryClient() usage, prefetch/dehydrate patterns, and mutation composition for robust caching.
• Developer DX: Mock API templates, chart/analytics parallel-route patterns, code conventions, and skeleton/loading/error patterns for predictable integration.

Quick Start

Create an orders dashboard feature with a mock API, api/service/queries/mutations, Zod schema, listing table, row actions, and a create/edit sheet following the repository conventions.