# Project Name

> TypeScript + React monorepo. Deployed on Vercel.

## Code Style

- TypeScript strict mode — no `any`, no `ts-ignore`
- Named exports only (no default exports)
- Prefer functional patterns: map/filter/reduce over for-loops
- Error handling: use Result<T, E> from `src/lib/result.ts`

## Architecture

- `src/routes/`   — Route handlers (thin layer, delegates to services)
- `src/services/`  — Business logic, one file per domain entity
- `src/db/`        — Drizzle ORM schema and query helpers
- `src/lib/`       — Shared utilities (logger, result type, validation)

## Commands

```bash
pnpm install          # Install dependencies
pnpm dev              # Start dev server (port 3000)
pnpm test             # Run Vitest suite
pnpm test:e2e         # Run Playwright tests
pnpm lint             # ESLint + Prettier check
pnpm db:migrate       # Run pending Drizzle migrations
```

## Git Conventions

- Conventional Commits: `feat:`, `fix:`, `chore:`, `docs:`
- Branch naming: `feat/short-description`, `fix/issue-number`
- Squash merge to main; delete branches after merge

## Notes

- The `src/legacy/` directory is being migrated. Do not add new code there.
- All dates are stored as UTC. Never use local time.

@docs/api-patterns.md
@docs/database-conventions.md

# Project Instructions

## Stack
- React 19 with TypeScript
- Supabase for backend (auth, database, storage)
- TailwindCSS v4 + shadcn/ui components
- Vite for building

## Architecture
- Feature-based folder structure
- Each feature owns its components, hooks, and types
- Shared components in src/components/ui/
- All API calls go through src/lib/supabase.ts

## Conventions
- Use shadcn/ui components before creating custom ones
- Mobile-first responsive design
- Use Supabase RLS policies for authorization
- Prefer server-side filtering over client-side

## Brand
- Primary color: #6366F1 (indigo)
- Font: Inter for body, Cal Sans for headings
- Rounded corners (radius-lg) on all cards