1 files changed, 121 insertions, 0 deletions
diff --git a/QUICKSTART.md b/QUICKSTART.md
new file mode 100644
index 0000000..e8dbf71
--- /dev/null
+++ b/QUICKSTART.md
@@ -0,0 +1,121 @@
+# Quick Start Guide
+
+## 5-Minute Setup
+
+### 1. Get API Keys
+
+#### Todoist (Required)
+1. Go to https://todoist.com/app/settings/integrations
+2. Scroll to "Developer" section
+3. Copy your **API token**
+
+#### Trello (Required)
+1. Go to https://trello.com/power-ups/admin
+2. Create a Power-Up (any name, e.g., "Personal Dashboard")
+3. Go to **API Key** tab
+4. Click **"Generate a new API Key"** and copy it (NOT the Secret!)
+5. In the API Key description, follow the "testing/for-yourself" instructions
+6. Click the **Token** link to generate a personal token
+7. Click **"Allow"** and copy the token
+
+**Important:** You need the API Key + Token (NOT the Secret). The Secret is for OAuth and not used for personal access.
+
+**That's it!** You now have everything you need.
+
+### 2. Configure
+
+```bash
+# Copy template
+cp .env.example .env
+
+# Edit .env and add:
+TODOIST_API_KEY=your_todoist_token
+TRELLO_API_KEY=your_trello_key
+TRELLO_TOKEN=your_trello_token
+```
+
+### 3. Run
+
+```bash
+go run cmd/dashboard/main.go
+```
+
+### 4. Access
+
+Open http://localhost:8080 in your browser!
+
+---
+
+## Optional: Add More Features
+
+### Obsidian Notes
+Add to `.env`:
+```bash
+OBSIDIAN_VAULT_PATH=/path/to/your/vault
+```
+
+### Claude.ai Access
+```bash
+# Generate key
+openssl rand -hex 32
+
+# Add to .env
+AI_AGENT_API_KEY=generated_key_here
+```
+
+Then share with Claude:
+- URL: `http://localhost:8080/api/claude/snapshot`
+- Token: (your AI_AGENT_API_KEY)
+
+---
+
+## What You'll See
+
+**Main Dashboard:**
+- 📋 **Trello Boards** at the top (your primary view)
+- ✓ **Todoist Tasks** below
+- 📝 **Recent Notes** (if Obsidian configured)
+- 🍽️ **Meal Plans** (if PlanToEat configured - optional)
+
+**Features:**
+- Auto-refresh every 5 minutes
+- Manual refresh button
+- Mobile-responsive design
+- Fast SQLite caching
+
+---
+
+## Troubleshooting
+
+### Can't start - missing API keys
+Make sure your `.env` has:
+```bash
+TODOIST_API_KEY=something
+TRELLO_API_KEY=something
+TRELLO_TOKEN=something
+```
+
+All three are required. Get them from:
+- Todoist: https://todoist.com/app/settings/integrations
+- Trello: https://trello.com/power-ups/admin (create Power-Up, generate both from API Key tab)
+
+### No boards showing
+- Check your Trello API key and token are correct
+- Make sure you have boards in your Trello account
+- Click the refresh button
+
+### No tasks showing
+- Verify Todoist API token is correct
+- Check you have active tasks in Todoist
+
+---
+
+## Next Steps
+
+1. ✅ Dashboard is running
+2. Check that data is loading
+3. Test the refresh button
+4. (Optional) Set up Claude.ai access
+5. Start using your unified dashboard!
+
+Need more details? See `SETUP_GUIDE.md` for comprehensive instructions.