kiranism-shadcn-dashboard

Automate Next.js shadcn dashboard features with src/features and React Query patterns.

Updated Aug 15, 2025
One-click install
npx skills add https://github.com/gesmith0606/nfl_data_engineering --skill kiranism-shadcn-dashboard
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: kiranism-shadcn-dashboard
Source: https://github.com/gesmith0606/nfl_data_engineering/tree/main/web/frontend/.agents/skills/kiranism-shadcn-dashboard
Command: npx skills add https://github.com/gesmith0606/nfl_data_engineering --skill kiranism-shadcn-dashboard

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

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.

Frequently Asked Questions about kiranism-shadcn-dashboard

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I structure a new feature module in a Next.js shadcn dashboard?▼

Structure new Next.js shadcn dashboard feature modules by co-locating API layers, Zod schemas, components, and mock-API data within src/features to standardize listing, detail, and edit flows.

What's the best way to implement data tables and forms using shadcn and TanStack?▼

Implement shadcn data tables using useSuspenseQuery and DataTable patterns, and build forms with TanStack Form combined with Zod schemas for robust validation.

How does server-side prefetching work with React Query in a Next.js dashboard?▼

Server-side prefetching in a Next.js dashboard uses getQueryClient() with queryOptions to fetch data, dehydrate the state, and wrap components in a HydrationBoundary for seamless client hydration.

Can I use shadcn/ui components to add RBAC-enabled navigation for admin panels?▼

Yes, you can implement RBAC-enabled navigation for admin panels by configuring nav-config rules that integrate Clerk organizations, specific permissions, and plan gating.

Do I need to use mock-api services when building shadcn dashboard pages?▼

Yes, using mock-api services is a required convention for building shadcn dashboard pages to ensure predictable integration and provide template data for listing and detail flows.

How do I manage mutations and caching with React Query in Next.js shadcn templates?▼

Manage caching and mutations in Next.js shadcn templates by using mutationOptions abstractions and composing mutation patterns to maintain robust client-side state.