website-nextjs-dashboard-project-structure
Installation
SKILL.md
Rule
The top-level shape
src/
app/ # routes — see website-nextjs-dashboard-route-organization
components/
ui/ # generic design-system primitives (button, card, field, table, ...)
<feature>/ # multi-file, cross-route feature component groups (sidebar/, achievements/)
*.tsx # single-file, cross-route components (error-boundary.tsx, offline-banner.tsx, ...)
contexts/ # home-grown React context + hook pairs (app-wide ambient state)
providers/ # thin wrappers around third-party providers (query client, etc.)
hooks/ # reusable custom hooks, one concern per file
lib/ # business logic + utilities that aren't components or hooks
types/ # global ambient types, .d.ts augmentations