A CLAUDE.md is just a markdown file at the root of your repo. Copy the content below into your own project's CLAUDE.md to give your agent the same context.
npx versuz@latest install kiranism-next-shadcn-dashboard-starter --kind=claude-mdcurl -o CLAUDE.md https://raw.githubusercontent.com/Kiranism/next-shadcn-dashboard-starter/HEAD/CLAUDE.md# CLAUDE.md This is a Next.js 16 + shadcn/ui admin dashboard starter kit. ## Key References - **[AGENTS.md](./AGENTS.md)** — Full project overview, tech stack, structure, conventions, data fetching patterns, deployment - **[docs/forms.md](./docs/forms.md)** — Form system: TanStack Form + Zod, composable fields, validation, multi-step, sheet/dialog forms - **[docs/themes.md](./docs/themes.md)** — Theme system: OKLCH colors, adding themes, font config - **[docs/nav-rbac.md](./docs/nav-rbac.md)** — Navigation RBAC: access control, Clerk integration - **[docs/clerk_setup.md](./docs/clerk_setup.md)** — Clerk auth setup: organizations, billing, environment variables ## Critical Conventions - **React Query** for all data fetching — `void prefetchQuery()` on server + `useSuspenseQuery` on client (standard TanStack pattern), `useMutation` for forms, `HydrationBoundary` + `dehydrate` for hydration, `<Suspense fallback>` for streaming - **API layer** per feature — `api/types.ts` → `api/service.ts` → `api/queries.ts`; queries use key factories (`entityKeys.all/list/detail`); components import from service and queries, never from mock APIs directly - **nuqs** for URL search params — `searchParamsCache` on server, `useQueryStates` on client, use `getSortingStateParser` for sort (same parser as `useDataTable`) - **Icons** — only import from `@/components/icons`, never from `@tabler/icons-react` directly - **Forms** — use `useAppForm` + `useFormFields<T>()` from `@/components/ui/tanstack-form` - **Page headers** — use `PageContainer` props (`pageTitle`, `pageDescription`, `pageHeaderAction`), never import `<Heading>` manually - **Formatting** — single quotes, JSX single quotes, no trailing comma, 2-space indent