# PROJECT_SETUP.md - Project Location Rules

## Golden Rule

**ALL projects MUST be created in `/Users/mattbruce/Documents/Projects/OpenClaw/`**

Never create projects in:
- ❌ `/Users/mattbruce/` (root home directory)
- ❌ `/Users/mattbruce/.openclaw/workspace/` (agent workspace)
- ❌ Any other random location

## Folder Structure

```
/Users/mattbruce/Documents/Projects/OpenClaw/
├── Documents/          # Documentation, specs, plans
├── iOS/               # iOS apps (Swift/Xcode)
└── Web/               # Web apps (Next.js/React)
    ├── blog-backup/
    ├── gantt-board/
    ├── heartbeat-monitor/
    ├── mission-control/
    └── [NEW_PROJECT]/   # Always put new web projects here
```

## Project Types

| Type | Location | Example |
|------|----------|---------|
| iOS Apps | `OpenClaw/iOS/[project]/` | `OpenClaw/iOS/MyApp/` |
| Web Apps | `OpenClaw/Web/[project]/` | `OpenClaw/Web/dashboard/` |
| Documents | `OpenClaw/Documents/` | `OpenClaw/Documents/plans/` |

## Before Creating Any Project

1. **Check TOOLS.md** for existing projects (avoid duplicates)
2. **Choose correct folder** based on project type
3. **Verify location** before running `npx create-next-app` or similar
4. **Update TOOLS.md** with new project details immediately

## If You Mess Up

If a project is created in the wrong place:
```bash
# Move it to correct location
mv ~/wrong-location/project ~/Documents/Projects/OpenClaw/Web/

# Update any hardcoded paths
# Update TOOLS.md
```

## Examples

**Correct:**
```bash
cd /Users/mattbruce/Documents/Projects/OpenClaw/Web
npx create-next-app new-dashboard
```

**Incorrect:**
```bash
cd /Users/mattbruce          # WRONG!
npx create-next-app new-dashboard
```

---

**Remember:** The OpenClaw folder is the single source of truth for all projects.