summaryrefslogtreecommitdiff
path: root/TRELLO_AUTH_UPDATE.md
diff options
context:
space:
mode:
authorPeter Stone <thepeterstone@gmail.com>2026-01-12 09:27:16 -1000
committerPeter Stone <thepeterstone@gmail.com>2026-01-12 09:27:16 -1000
commit9fe0998436488537a8a2e8ffeefb0c4424b41c60 (patch)
treece877f04e60a187c2bd0e481e80298ec5e7cdf80 /TRELLO_AUTH_UPDATE.md
Initial commit: Personal Consolidation Dashboard (Phase 1 Complete)
Implemented a unified web dashboard aggregating tasks, notes, and meal planning: Core Features: - Trello integration (PRIMARY feature - boards, cards, lists) - Todoist integration (tasks and projects) - Obsidian integration (20 most recent notes) - PlanToEat integration (optional - 7-day meal planning) - Mobile-responsive web UI with auto-refresh (5 min) - SQLite caching with 5-minute TTL - AI agent endpoint with Bearer token authentication Technical Implementation: - Go 1.21+ backend with chi router - Interface-based API client design for testability - Parallel data fetching with goroutines - Graceful degradation (partial data on API failures) - .env file loading with godotenv - Comprehensive test coverage (9/9 tests passing) Bug Fixes: - Fixed .env file not being loaded at startup - Fixed nil pointer dereference with optional API clients (typed nil interface gotcha) Documentation: - START_HERE.md - Quick 5-minute setup guide - QUICKSTART.md - Fast track setup - SETUP_GUIDE.md - Detailed step-by-step instructions - PROJECT_SUMMARY.md - Complete project overview - CLAUDE.md - Guide for Claude Code instances - AI_AGENT_ACCESS.md - AI agent design document - AI_AGENT_SETUP.md - Claude.ai integration guide - TRELLO_AUTH_UPDATE.md - New Power-Up auth process Statistics: - Binary: 17MB - Code: 2,667 lines - Tests: 5 unit + 4 acceptance tests (all passing) - Dependencies: chi, sqlite3, godotenv Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Diffstat (limited to 'TRELLO_AUTH_UPDATE.md')
-rw-r--r--TRELLO_AUTH_UPDATE.md78
1 files changed, 78 insertions, 0 deletions
diff --git a/TRELLO_AUTH_UPDATE.md b/TRELLO_AUTH_UPDATE.md
new file mode 100644
index 0000000..eee0533
--- /dev/null
+++ b/TRELLO_AUTH_UPDATE.md
@@ -0,0 +1,78 @@
+# Trello Authentication Update
+
+## What Changed (January 2026)
+
+Trello moved from the simple app-key page to a Power-Up based API key system.
+
+### Old Process (Deprecated)
+- Go to https://trello.com/app-key
+- API key shown at top of page
+- Click "Token" link to generate token
+
+### New Process (Current)
+1. Go to https://trello.com/power-ups/admin
+2. Create a Power-Up (any name, e.g., "Personal Dashboard")
+3. Go to the Power-Up's **"API Key"** tab
+4. Click **"Generate a new API Key"**
+5. Copy the **API Key** (NOT the Secret - you won't use that!)
+6. In the description below the API Key, find the "testing/for-yourself" instructions
+7. Click the **"Token"** link in those instructions
+8. Click **"Allow"** to authorize
+9. Copy the token
+
+**Important Note:**
+- The API Key tab shows both an **API Key** and a **Secret**
+- For personal use, you need: **API Key + Token** (NOT Secret)
+- The Secret is only used for OAuth applications, not personal access
+- Follow the "testing" or "for-yourself" instructions to generate your token
+
+## What Stayed the Same
+
+### Authentication Method
+The actual API authentication hasn't changed:
+- Still uses API Key + Token
+- Still passed as query parameters: `?key=XXX&token=YYY`
+- No code changes needed in `internal/api/trello.go`
+
+### API Endpoints
+All Trello API endpoints remain the same:
+- Base URL: `https://api.trello.com/1`
+- `/members/me/boards` - Get user boards
+- `/boards/{id}/cards` - Get board cards
+- `/boards/{id}/lists` - Get board lists
+
+## Code Impact
+
+✅ **No code changes required**
+
+The application code already uses the correct authentication method. Only documentation needed updates.
+
+## Documentation Updated
+
+All documentation has been updated to reflect the new process:
+- ✅ `.env.example` - Updated instructions
+- ✅ `START_HERE.md` - Updated quick start
+- ✅ `QUICKSTART.md` - Updated 5-min guide
+- ✅ `README.md` - Updated installation steps
+- ✅ `SETUP_GUIDE.md` - Updated detailed setup and troubleshooting
+- ✅ `PROJECT_SUMMARY.md` - Updated quick reference
+- ✅ `CLAUDE.md` - Updated for Claude Code instances
+
+## References
+
+- New Power-Up Admin Portal: https://trello.com/power-ups/admin
+- Trello REST API Docs: https://developer.atlassian.com/cloud/trello/rest/
+- Authorization Guide: https://developer.atlassian.com/cloud/trello/guides/rest-api/authorization/
+
+## Testing
+
+Authentication works the same way. Test with:
+```bash
+curl "https://api.trello.com/1/members/me/boards?key=YOUR_KEY&token=YOUR_TOKEN"
+```
+
+Should return JSON array of your boards. A 401 error means invalid credentials.
+
+---
+
+**Last Updated:** January 12, 2026