diff options
| author | Peter Stone <thepeterstone@gmail.com> | 2026-01-12 09:27:16 -1000 |
|---|---|---|
| committer | Peter Stone <thepeterstone@gmail.com> | 2026-01-12 09:27:16 -1000 |
| commit | 9fe0998436488537a8a2e8ffeefb0c4424b41c60 (patch) | |
| tree | ce877f04e60a187c2bd0e481e80298ec5e7cdf80 /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.md | 78 |
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 |
