Project Architecture Guide

# Project Architecture

## Tech Stack
- Framework: [Next.js / Express / etc.]
- Database: [PostgreSQL / MongoDB / etc.]
- ORM: [Prisma / Drizzle / etc.]

## Directory Structure
- `app/` - Next.js app router pages
- `components/` - Reusable UI components
- `lib/` - Shared utilities and helpers
- `hooks/` - Custom React hooks
- `types/` - TypeScript type definitions

## Key Patterns
- Use server components by default, `'use client'` only when needed
- Data fetching happens in server components or API routes
- State management via React context for global state, useState for local

## Build & Run
- `npm run dev` - Start development server
- `npm run build` - Production build
- `npm test` - Run test suite