homelab-topology/.sisyphus/notepads/remaining-features/learnings.md

Learnings - Wave 1

Task 1: Express Backend Foundation

What worked well

• Used bun add to install dependencies - fast and straightforward
• tsx is already available in devDependencies, so no additional setup needed
• CORS configured to allow http://localhost:3000 (frontend)
• Health endpoint returns expected JSON: {"status":"ok"}

Dependencies added

• express@5.2.1
• cors@2.8.6
• @types/express@5.0.6
• @types/cors@2.8.19

Files created/modified

• Created: server/index.ts
• Modified: package.json (added "server": "tsx server/index.ts" script)

Verification

• curl http://localhost:3001/api/health returns {"status":"ok"} ✓

Notes

• Server runs on port 3001 to avoid conflict with frontend on port 3000
• Minimal setup - no authentication, no WebSocket support (as per requirements)
• Evidence saved to .sisyphus/evidence/task-1-health-check.json