CLAUDE.md

1# Next.js TypeScript Starter
2 
3## Tech Stack
4- Next.js 14+ with App Router
5- TypeScript (strict mode)
6- Tailwind CSS
7- ShadCN UI components
8- Redux Toolkit for state management
9 
10## Commands
11```bash
12yarn dev          # Start development server
13yarn build        # Production build
14yarn lint         # Run ESLint
15yarn type-check   # TypeScript check
16```
17 
18## Directory Structure
19```
20src/
21├── app/          # Next.js pages and layouts
22├── components/   # Reusable UI components
23│   └── lib/shadcn/  # ShadCN CLI-managed (DO NOT MODIFY)
24├── services/api/ # API service logic and Axios setup
25├── store/        # Redux Toolkit store and slices
26├── utils/        # Utility/helper functions
27└── styles/       # Tailwind style constants
28```
29 
30## Critical Rules
31 
32### ShadCN Components
33**DO NOT MODIFY** files in `src/components/lib/shadcn/ui/`. Create wrapper components instead.
34 
35### Async Code
36Always use `async/await` over `.then()` chains.
37 
38### Imports
39Import order (enforced by ESLint):
401. External libraries
412. Aliased internal (`@/services`, `@/components`)
423. Relative imports
43 
44Separate groups with blank lines.
45 
46## Rules Reference
47- TypeScript conventions: `.claude/rules/typescript.md`
48- React patterns: `.claude/rules/react.md`
49- Styling guide: `.claude/rules/styling.md`
50- ShadCN usage: `.claude/rules/shadcn.md`
51- Git commits: `.claude/rules/git-commits.md`
52