# Project Blueprint

> This is your project's source of truth.
> Claude reads this to understand WHAT to build.

---

## Project Overview

**Name:** [Project Name]
**Tagline:** [One-line description]
**Domain:** [e.g., yourproject.com]

### Problem Statement
[What problem does this solve? Who has this problem?]

### Solution
[How does your project solve it?]

### Target Users
- **Primary:** [Main user type]
- **Secondary:** [Other users]

---

## Features

### Phase 1: MVP (Current)
- [ ] **Feature 1** - [Description]
  - Sub-requirement 1
  - Sub-requirement 2
- [ ] **Feature 2** - [Description]
- [ ] **Feature 3** - [Description]

### Phase 2: Growth
- [ ] **Feature 4** - [Description]
- [ ] **Feature 5** - [Description]

### Phase 3: Scale
- [ ] **Feature 6** - [Description]

---

## Data Model

### Core Entities

```
User
├── id: string (UUID)
├── email: string (unique)
├── name: string
├── role: enum (user, admin)
├── createdAt: timestamp
└── updatedAt: timestamp

[Entity 2]
├── id: string (UUID)
├── [field]: [type]
└── userId: string (FK → User)
```

### Relationships
- User → [Entity] (one-to-many)
- [Entity] → [Entity] (many-to-many)

---

## API Endpoints

### Public Routes
| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | /api/[resource] | List all |
| GET | /api/[resource]/:id | Get one |
| POST | /api/[resource] | Create |

### Protected Routes (Auth Required)
| Method | Endpoint | Description |
|--------|----------|-------------|
| PUT | /api/[resource]/:id | Update |
| DELETE | /api/[resource]/:id | Delete |

### Admin Routes
| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | /api/admin/[resource] | Admin list |

---

## Pages & Routes

| Route | Page | Auth | Description |
|-------|------|------|-------------|
| `/` | HomePage | No | Landing page |
| `/[resource]` | ListPage | No | Browse items |
| `/[resource]/:id` | DetailPage | No | View item |
| `/dashboard` | Dashboard | Yes | User dashboard |
| `/admin` | AdminPanel | Admin | Admin controls |

---

## Authentication & Authorization

### Auth Method
[e.g., JWT, Session, OAuth]

### Roles
| Role | Permissions |
|------|-------------|
| guest | View public content |
| user | + Create, edit own content |
| admin | + Manage all content, users |

---

## UI/UX Requirements

### Design System
- **Colors:** [Primary, Secondary, Accent]
- **Typography:** [Font family]
- **Components:** [shadcn/ui, custom]

### Key UI Patterns
- [ ] Mobile-first responsive
- [ ] Dark mode support
- [ ] Loading skeletons
- [ ] Toast notifications
- [ ] Form validation feedback

---

## Third-Party Integrations

| Service | Purpose | Priority |
|---------|---------|----------|
| [Service 1] | [Purpose] | Required |
| [Service 2] | [Purpose] | Optional |

---

## Success Metrics

- [ ] [Metric 1]: [Target]
- [ ] [Metric 2]: [Target]

---

## Out of Scope (v1)

Things we're NOT building initially:
- [Feature X] - Deferred to v2
- [Feature Y] - Requires more research

---

## Notes for Claude

### When building features:
1. Check this blueprint for requirements
2. Reference the Data Model for types
3. Follow the API patterns established
4. Match the UI/UX requirements

### Feature completeness:
- Blueprint requirements (this file)
- Quality standards (`AI_RULES.md`)
- Workflow process (`CLAUDE.md`)

**Build what's specified. Build it completely.**