Cline rules

1## Brief overview
2 
3This Cline rule file outlines the coding conventions, naming conventions, folder structure, code styles, tech stack, and tools used in the current project.
4 
5## Code Conventions
6 
7- Use TypeScript for all code.
8- Strong typing with no 'any'.
9- Interfaces over types for object definitions.
10- Const assertions for literals.
11- Discriminated unions for complex states.
12- Functional components only.
13- Props interface for every component.
14- Early returns for conditional rendering.
15- Error boundaries for error handling.
16 
17## Naming Conventions
18 
19- Files/Directories: kebab-case
20- Components: PascalCase
21- Functions/Variables: camelCase
22- Constants: SCREAMING_SNAKE_CASE
23- Types/Interfaces: PascalCase
24 
25## Folder Structure
26 
27- Follow the defined directory organization:
28```plaintext
29  ├── app/
30  │   ├── api/            # API routes
31  │   ├── (dashboard)/    # Dashboard routes group
32  │   └── _components/    # Page-specific components
33  ├── components/
34  │   ├── ui/            # Shadcn components
35  │   └── shared/        # Shared components
36  ├── lib/
37  │   ├── utils/         # Utility functions
38  │   ├── config/        # Configuration
39  │   └── types/         # TypeScript types
40  ├── hooks/             # Custom React hooks
41  └── public/            # Static assets
42```
43- Co-locate related files.
44- Keep components close to where they're used.
45- Shared code goes up the tree.
46 
47## Code Styles
48 
49- ESLint for code quality.
50- Prettier for formatting.
51- TypeScript strict mode.
52- Husky pre-commit hooks.
53- Maximum file size: 300 lines.
54- Maximum function size: 50 lines.
55 
56## Tech Stack
57 
58- Frontend Framework: Next.js 14.x
59- Language: TypeScript 5.x
60- State Management:
61  - Server State: @tanstack/react-query v5
62  - URL State: nuqs
63  - Form State: react-hook-form
64- UI Components:
65  - Shadcn UI (Base components)
66  - Radix UI (Accessibility)
67  - TailwindCSS (Styling)
68- Data Display: @tanstack/react-table
69- Validation: Zod
70- Routing: Next.js App Router with Parallel Routes
71 
72## Tools
73 
74- Node.js ≥ 18.17
75- pnpm (for package management)
76- VS Code with recommended extensions
77- Git ≥ 2.40
78 
79## AI Code Guidelines
80 
81- AI-generated code should adhere to all existing project conventions and standards.
82- Review and refactor AI-generated code for clarity, efficiency, and maintainability.
83- Ensure AI-generated code includes appropriate comments and documentation.
84- Verify AI-generated code against project requirements and test cases.
85