427e7578-d7bf-49c8-aee9-2dd999e25316/TASKS.md

TASKS.md

Implementation progress tracker for the P2P Poll App.

Setup

• Scaffold Waku project with bunx create-waku@latest
• Install Automerge dependencies
• Install Tailwind CSS v4 and @tailwindcss/vite
• Create waku.config.ts with Tailwind Vite plugin
• Create src/styles/global.css with Tailwind import
• Verify bun run dev starts without errors

Core Logic

• Create src/lib/types.ts with Poll and PollOption interfaces
• Create src/lib/peer.ts with localStorage-backed peer ID generation
• Implement createPoll in src/lib/poll.ts
• Implement addOption in src/lib/poll.ts
• Implement vote and unvote in src/lib/poll.ts
• Implement hasVoted in src/lib/poll.ts

Automerge Integration

• Create src/lib/repo.ts with Repo singleton (WebSocket, BroadcastChannel, IndexedDB)
• Create src/components/Providers.tsx with RepoContext.Provider

Pages & Routing

• Create src/pages/_layout.tsx (server component with Providers and global CSS)
• Create src/pages/index.tsx with create-poll and join-poll UI
• Create src/pages/poll/[id].tsx with useDocument and Suspense

UI Components

• Build src/components/PollView.tsx (title, options list, vote/unvote buttons)
• Add "Add Option" form to PollView
• Add shareable link / copy button to PollView
• Build src/components/ConnectionStatus.tsx

Tests

• Test: getPeerId generates and persists a UUID
• Test: createPoll returns poll with title and empty options
• Test: addOption appends option with text, id, and empty votes
• Test: vote adds peer ID to option's votes array
• Test: double-vote prevention (no duplicate entries)
• Test: unvote removes peer ID from votes array

Polish

• Tailwind styling (centered layout, card-style poll, vote bars)
• Loading states for document sync
• Error handling for invalid/missing document IDs
• Cross-tab sync testing (BroadcastChannel)
• Multi-device sync testing