trails/openspec/changes/planner-multiplayer-awareness/tasks.md
Ullrich Schäfer 9b4f4c6759
Add multiplayer awareness: participant list, name editing, cursor styling, join/leave toasts
Implement the planner-multiplayer-awareness OpenSpec change:

- Add setUserName to use-yjs.ts that persists to localStorage and syncs via awareness
- Create ParticipantList component showing all session participants with color dots,
  host badge, and inline name editing for the local user
- Replace plain text cursor labels with SVG pointer arrows and styled name tags
  (colored background, drop shadow, rounded corners, z-index below map controls)
- Track awareness add/remove events and display auto-dismissing toasts (3s)
  when participants join or leave the session
- Add i18n keys for participant UI in English and German

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-25 08:40:35 +01:00

27 lines
1.1 KiB
Markdown

## 1. Name Editing
- [x] 1.1 Update use-yjs.ts: allow updating user name via a returned setter function
- [x] 1.2 Save updated name to localStorage and sync via awareness.setLocalStateField
- [x] 1.3 Add i18n keys for participant UI (en + de)
## 2. Participant List
- [x] 2.1 Create ParticipantList component showing all awareness states (name, color dot, host badge)
- [x] 2.2 Add inline name edit when clicking own name in the list
- [x] 2.3 Integrate ParticipantList into SessionView header
## 3. Cursor Styling
- [x] 3.1 Replace current divIcon cursor with SVG pointer arrow + styled name tag (background, shadow, rounded)
- [x] 3.2 Set cursor z-index below map controls to avoid overlap
## 4. Join/Leave Toasts
- [x] 4.1 Track awareness changes (added/removed clients) in SessionView
- [x] 4.2 Show auto-dismissing toast when participant joins or leaves (3 second duration)
## 5. Verify
- [x] 5.1 Test with two browser windows: verify participant list, name editing, cursor rendering
- [x] 5.2 Verify join/leave toasts appear correctly
- [x] 5.3 Verify name persists across page refresh (localStorage)