# Development Quick Start (1 Minute Setup)

For macOS/Linux developers who want fast local development.

## TL;DR

```bash
# Setup (first time only)
./dev-setup.sh

# Start development
./dev.sh

# Open http://localhost:3000

# Stop when done
./dev-stop.sh
```

## What You Get

✅ **Backend** on http://localhost:8000
✅ **Frontend** on http://localhost:3000  
✅ **Hot reload** for both
✅ **Auto-restart** on file changes
✅ **API docs** at http://localhost:8000/docs

## Requirements

- Python 3.13 (`brew install python@3.13` on macOS)
- uv (auto-installed by setup script)
- Node.js 18+
- FFmpeg (`brew install ffmpeg` on macOS)

## Why This is Faster Than Docker

| Feature | Local Dev | Docker |
|---------|-----------|--------|
| Startup | 2-5 sec | 10-30 sec |
| Hot Reload | Instant | 1-2 sec |
| File Changes | Native speed | Volume overhead |

## Commands

```bash
./dev-setup.sh     # Setup once
./dev.sh           # Start both servers
./dev-stop.sh      # Stop servers
./dev-backend.sh   # Backend only
./dev-frontend.sh  # Frontend only
```

## Logs

```bash
tail -f logs/backend.log
tail -f logs/frontend.log
```

That's it! See [LOCAL_DEV_GUIDE.md](LOCAL_DEV_GUIDE.md) for more details.