# Application Guidelines

## Architecture
- This is a monorepo managed with Turborepo
- Apps: web (Next.js), api (Express), mobile (React Native)
- Shared packages: ui, config, types

## Code Standards
- TypeScript strict mode in all packages
- Use barrel exports (index.ts) for public APIs
- No default exports; use named exports everywhere
- Prefer async/await over raw Promises

## API Design
- RESTful endpoints follow /api/v1/{resource} pattern
- All responses use { data, error, meta } envelope
- Validate request bodies with Zod schemas
- Return 4xx for client errors, 5xx for server errors

## Database
- Use Prisma ORM for all database operations
- Migrations checked into source control
- Soft-delete pattern: use deletedAt timestamp, never hard delete
- All timestamps stored as UTC

## Testing
- Jest for unit tests, Playwright for E2E
- Test files colocated: foo.ts -> foo.test.ts
- Mock external services, never call real APIs in tests

# Project Rules

## Stack
- TypeScript 5.x with strict mode
- React 19 with Server Components
- Tailwind CSS v4
- Drizzle ORM with PostgreSQL

## Code Style
- Prefer named exports over default exports
- Use "use client" directive only when interactivity is required
- Colocate tests in __tests__ directories next to source files
- Use Zod for all runtime validation

## Architecture
- App Router with nested layouts in app/
- Server actions in app/actions/
- Database schema in db/schema.ts
- Shared utilities in lib/

## Commands
- Dev server: pnpm dev
- Type check: pnpm typecheck
- Test: pnpm test
- Lint: pnpm lint