# Project Rules

## Stack
- TypeScript 5.x with strict mode
- React 19 + Next.js 15 (App Router)
- Tailwind CSS v4 for styling
- Drizzle ORM for database access

## Code Standards
- Named exports only (no default exports)
- Prefer `const` assertions and satisfies operator
- Use Result<T, E> pattern for error handling
- Maximum 30 lines per function

## File Organization
- Colocate tests: `foo.ts` → `foo.test.ts`
- One component per file
- Barrel exports (index.ts) for public module APIs

## Git
- Conventional commits: feat|fix|chore|docs|test
- Squash merge feature branches
- Branch naming: type/description

---
description: React component conventions and patterns
globs: "*.tsx,*.jsx"
alwaysApply: false
---
# React Component Rules

1. Use functional components with TypeScript interfaces for props
2. Prefer server components by default — add "use client" only for interactivity
3. Colocate component tests in adjacent __tests__/ directories
4. Use named exports, not default exports
5. Extract custom hooks into hooks/ directory when reused across components

## Styling
- Use Tailwind CSS v4 utility classes
- Follow mobile-first responsive design
- Keep component-specific styles colocated

## State Management
- Use React 19 use() for async data in server components
- Prefer URL state (searchParams) over client state where possible
- Use Zustand for complex client-side state