add proposal

.gitignore

@@ -1,6 +1,3 @@
 node_modules
 dist
-dist-ssr
-*.local
-.env
 .DS_Store

MVP_PLAN.md

@@ -0,0 +1,310 @@
+# Minimal MVP Plan: P2P Poll App
+
+## Recommendation
+
+Build the MVP with:
+
+- Vanilla JS or TypeScript
+- Vite for local dev/build
+- Yjs for shared state
+- `y-webrtc` for browser-to-browser sync
+- `y-indexeddb` for local persistence/offline recovery
+
+This is the best fit for a small poll app because the data model is tiny, concurrent edits are possible, and Yjs already solves merge/conflict handling while `y-webrtc` gives a direct P2P transport with only signaling infrastructure.
+
+## Why This Stack
+
+### Recommended: Yjs + y-webrtc
+
+- Best balance of simplicity and correctness
+- Clients connect directly over WebRTC
+- No custom conflict-resolution logic needed
+- Easy to add offline persistence
+- Good fit for a single shared document/room
+
+### Not recommended for the first MVP
+
+#### PeerJS
+
+- Very simple transport layer
+- But you must design and maintain your own replication and merge rules
+- Fine for demos with a host-authoritative peer, weaker for true collaborative editing
+
+#### GUN
+
+- Fast to prototype realtime shared state
+- But official tutorials commonly use a GUN peer/relay server for shared data
+- For this app, its data model is less explicit than a CRDT and gives less control over vote semantics
+
+#### Automerge
+
+- Very capable CRDT and local-first model
+- But heavier than needed for a single small poll
+- Better choice if the project is expected to evolve into a richer collaborative app
+
+## MVP Scope
+
+Ship exactly one shared poll per room.
+
+Included:
+
+- Join a poll by opening a shared URL
+- Add a new option
+- Vote for one option
+- Change your vote
+- Realtime updates across peers
+- Local persistence in the browser
+- Basic connection status UI
+
+Excluded:
+
+- User accounts
+- Multiple polls per room
+- Option deletion/editing
+- Authentication/authorization
+- Rich presence
+- Advanced discovery
+- Production-grade TURN/signaling deployment
+
+## MVP UX
+
+Keep the interface intentionally small:
+
+- Poll title at the top
+- Option list with vote counts
+- One button per option to cast vote
+- Small form to add an option
+- Status line showing `connecting`, `connected`, or `offline`
+- Small label showing which option you voted for
+
+Join model:
+
+- Room ID in the URL, e.g. `/?room=poll-demo`
+- Users share the URL manually
+
+Identity model:
+
+- Generate a local `userId` once and store it in `localStorage`
+- Optional local display name, also stored locally
+
+## Shared Data Model
+
+Use a single Yjs document per room.
+
+Suggested structure:
+
+- `poll` as a `Y.Map`
+- `poll.title` as a string
+- `poll.options` as a `Y.Map<optionId, Y.Map>`
+- `poll.votes` as a `Y.Map<userId, optionId>`
+
+Each option record:
+
+- `id`
+- `label`
+- `createdBy`
+- `createdAt`
+
+Important design choice:
+
+Do not store vote counters as mutable shared numbers for the MVP.
+Instead, derive counts from `votes`.
+
+Why:
+
+- A user changing vote becomes a single write: `votes[userId] = optionId`
+- No double-counting logic
+- Concurrent writes are easier to reason about
+- Rendering counts from `votes` is trivial at this scale
+
+## Sync Model
+
+### Networking
+
+- Use `WebrtcProvider(roomId, ydoc)`
+- Start with the default public signaling servers for local development
+- If needed, swap to a self-hosted signaling server later without changing the app model
+
+### Persistence
+
+- Use `IndexeddbPersistence(roomId, ydoc)`
+- This preserves state across reloads and helps when reconnecting after temporary disconnects
+
+### Conflict behavior
+
+- Concurrent option additions merge naturally
+- Concurrent vote changes resolve at the per-user key level
+- Tally is recalculated from the merged vote map
+
+## Suggested Project Structure
+
+```text
+src/
+  main.ts
+  app.ts
+  state.ts
+  sync.ts
+  render.ts
+  identity.ts
+  styles.css
+index.html
+```
+
+Responsibilities:
+
+- `sync.ts`: create Yjs doc, WebRTC provider, IndexedDB provider
+- `state.ts`: shared structures, add option, cast vote, selectors
+- `identity.ts`: local `userId` and optional name
+- `render.ts`: DOM updates
+- `app.ts`: wire events to state and rendering
+
+## Implementation Plan
+
+### Phase 1: App shell
+
+- Create Vite app with vanilla TS or JS
+- Add a minimal single-page UI
+- Parse `room` from the URL
+- Generate and persist `userId`
+
+Success check:
+
+- App loads
+- Room ID appears in UI
+- User can type in the form
+
+### Phase 2: Shared state
+
+- Add Yjs document
+- Create root shared maps
+- Seed default poll title if missing
+- Observe document updates and re-render UI
+
+Success check:
+
+- State exists in one browser tab
+- Refresh keeps local state when IndexedDB is enabled
+
+### Phase 3: P2P sync
+
+- Add `y-webrtc`
+- Join room based on URL room ID
+- Show connection status from provider events
+
+Success check:
+
+- Two browsers on different tabs/devices see the same options
+- New options appear in near real time
+
+### Phase 4: Voting logic
+
+- Implement `castVote(optionId)` as `votes.set(userId, optionId)`
+- Derive tallies from `votes`
+- Highlight the local user’s current vote
+
+Success check:
+
+- Votes update live across peers
+- Changing vote updates counts correctly
+
+### Phase 5: Basic hardening
+
+- Trim/validate option labels
+- Prevent empty options
+- Ignore duplicate labels case-insensitively for MVP
+- Show simple offline/connecting text
+
+Success check:
+
+- Basic misuse does not break the UI
+- Reconnect restores updates
+
+## Minimal API Surface
+
+These functions are enough for the first build:
+
+- `getRoomId(): string`
+- `getUserId(): string`
+- `initSync(roomId): AppSync`
+- `ensurePollInitialized()`
+- `addOption(label: string)`
+- `castVote(optionId: string)`
+- `getViewModel(): PollViewModel`
+- `render(viewModel)`
+
+## Risks And MVP Mitigations
+
+### NAT / WebRTC connectivity
+
+Risk:
+
+- Some peer pairs may fail to connect in restrictive networks
+
+Mitigation:
+
+- Accept this for MVP
+- Keep signaling configurable
+- Add TURN only if testing shows frequent failures
+
+### Small public signaling dependency
+
+Risk:
+
+- Public signaling is fine for demos, not ideal for production
+
+Mitigation:
+
+- Treat it as replaceable infrastructure
+- Self-host later if the prototype is kept
+
+### Duplicate or messy options
+
+Risk:
+
+- Users may add near-duplicate entries
+
+Mitigation:
+
+- Normalize labels
+- Prevent exact duplicates for MVP
+
+### No trust/auth model
+
+Risk:
+
+- Any participant in the room can add options and vote
+
+Mitigation:
+
+- Accept for MVP
+- Frame rooms as small trusted groups
+
+## Estimated MVP Size
+
+For one developer:
+
+- Initial prototype: 0.5 to 1 day
+- Polished MVP with basic resilience: 1 to 2 days
+
+Rough code size:
+
+- 250 to 500 lines plus styles
+
+## Nice Next Steps After MVP
+
+- Copy-link button
+- Participant list / presence
+- Vote limit modes: single-choice or multi-choice
+- Option editing/deletion
+- QR code for room join
+- Self-hosted signaling server
+- PWA packaging for better offline behavior
+
+## Sources
+
+- PeerJS getting started: https://peerjs.com/client/getting-started
+- Yjs collaborative editor guide: https://docs.yjs.dev/getting-started/a-collaborative-editor
+- Yjs offline support: https://docs.yjs.dev/getting-started/allowing-offline-editing
+- y-webrtc README: https://github.com/yjs/y-webrtc
+- GUN tutorial showing shared data via a GUN peer: https://gun.eco/converse
+- Automerge network sync: https://automerge.org/docs/tutorial/network-sync/

README.md

@@ -1,279 +1,39 @@
 # P2P Poll App
 
-A peer-to-peer polling application built with React, TypeScript, Tailwind CSS, Node.js, Yjs, and WebSocket for real-time collaborative voting.
+Small peer-to-peer polling app built with `Vite`, `TypeScript`, `Yjs`, `y-webrtc`, and `y-indexeddb`.
-
-**Users can create polls, add answers, and vote in real-time with automatic P2P synchronization across all connected clients.**
-
-## Architecture
-
-**Hybrid P2P Approach:**
-- Backend serves as both a Yjs WebSocket provider (for state synchronization) and signaling server (for WebRTC peer discovery)
-- Clients sync poll data via Yjs CRDT for conflict-free merging
-- Direct P2P connections via WebRTC for real-time updates when possible
-- Server fallback ensures reliability when P2P fails
-
-## Tech Stack
-
-**Backend:**
-- Node.js + TypeScript
-- Express.js
-- WebSocket (ws)
-- y-websocket (Yjs WebSocket provider)
-- CORS support
-
-**Frontend:**
-- React 18 + TypeScript
-- Vite (build tool)
-- Tailwind CSS
-- Yjs (CRDT library)
-- y-websocket (server sync)
-- y-webrtc (P2P sync)
-- lucide-react (icons)
-
-## Project Structure
-
-```
-quicgroup/
-├── server/                 # Backend Node.js server
-│   ├── src/
-│   │   ├── index.ts       # Main server entry
-│   │   ├── yjs-server.ts  # Yjs WebSocket provider
-│   │   ├── signaling-server.ts  # WebRTC signaling
-│   │   ├── types/         # TypeScript types
-│   │   └── utils/         # Utilities
-│   ├── package.json
-│   └── tsconfig.json
-│
-└── frontend/              # React frontend
-    ├── src/
-    │   ├── components/    # React components
-    │   ├── hooks/         # Custom React hooks
-    │   ├── lib/           # Yjs setup and utilities
-    │   ├── types/         # TypeScript types
-    │   └── styles/        # CSS styles
-    ├── package.json
-    └── vite.config.ts
-```
-
-## Setup Instructions
-
-### Prerequisites
-- Node.js 18+ and npm
-
-### Backend Setup
-
-1. Navigate to server directory:
-```bash
-cd server
-```
-
-2. Install dependencies:
-```bash
-npm install
-```
-
-3. Copy environment file:
-```bash
-cp .env.example .env
-```
-
-4. Start the development server:
-```bash
-npm run dev
-```
-
-The server will run on `http://localhost:3000` with:
-- Yjs WebSocket: `ws://localhost:3000/yjs`
-- Signaling WebSocket: `ws://localhost:3000/signal`
-
-### Frontend Setup
-
-1. Navigate to frontend directory:
-```bash
-cd frontend
-```
-
-2. Install dependencies:
-```bash
-npm install
-```
-
-3. Copy environment file (optional):
-```bash
-cp .env.example .env
-```
-
-4. Start the development server:
-```bash
-npm run dev
-```
-
-The frontend will run on `http://localhost:5173`
-
-## Running the Application
-
-1. **Start Backend** (Terminal 1):
-```bash
-cd server
-npm run dev
-```
-
-2. **Start Frontend** (Terminal 2):
-```bash
-cd frontend
-npm run dev
-```
-
-3. **Open Browser:**
-   - Navigate to `http://localhost:5173`
-   - Open multiple tabs/windows to test P2P synchronization
 
 ## Features
 
-### Dynamic Poll Creation
+- single shared poll per room
-- **Create Polls** - Any user can create new polls with custom questions
+- add options collaboratively
-- **Add Answers** - Anyone can add answer options to any poll
+- one vote per user, changeable at any time
-- **Real-time Voting** - Vote on options with instant updates across all clients
+- peer-to-peer sync over WebRTC
-- **Smart Vote Tracking** - One vote per user per option (prevents duplicate voting)
+- local browser persistence for refresh/reconnect recovery
-- **Visual Feedback** - Green border and " Voted" indicator on voted options
+- shareable room URL
-- **User Attribution** - See who created each poll and option
-- **Live Vote Counts** - See vote percentages and counts update in real-time
-- **P2P Synchronization** - Uses Yjs CRDT for conflict-free state merging
-- **Connection Status** - Visual indicator showing WebSocket and peer connections
-- **Hybrid Architecture** - Combines WebSocket server sync with WebRTC P2P
-- **Beautiful UI** - Modern gradient design with Tailwind CSS
 
-## How to Use
+## Run locally
 
-### Create a Poll
+```bash
-1. Enter your question in the "Create a New Poll" form at the top
+npm install
-2. Click "Create Poll"
+npm run dev
-3. Your poll appears instantly for all connected users
-
-### Add Answer Options
-1. Find the poll you want to add an answer to
-2. Type your answer in the "Add a new option..." field
-3. Click "Add"
-4. Your answer appears instantly for all users
-
-### Vote on Options
-1. Click the vote button (thumbs up icon) on any option
-2. You can only vote once per option
-3. Voted options show a green border and " Voted" indicator
-4. Vote counts update in real-time across all clients
-
-### Multi-User Testing
-1. Open multiple browser tabs/windows
-2. Create polls from different tabs
-3. Add answers from different tabs
-4. Vote from different tabs
-5. Watch real-time synchronization in action!
-
-## How It Works
-
-### CRDT Synchronization
-The app uses Yjs (a CRDT library) to ensure all clients converge to the same state without conflicts:
-- Each client maintains a local Yjs document
-- Changes are automatically synced via WebSocket to the server
-- WebRTC provides direct P2P connections between clients
-- Yjs handles merge conflicts automatically
-- One vote per user per option is enforced via `votedBy` tracking
-
-## Data Model
-```typescript
-{
-  polls: Array<{
-    id: string,
-    question: string,
-    createdBy: string,
-    timestamp: number,
-    options: Array<{
-      id: string,
-      text: string,
-      votes: number,
-      votedBy: string[],  // Tracks which users have voted
-      createdBy: string,
-      timestamp: number
-    }>
-  }>
-}
 ```
 
-## Testing P2P Functionality
+Open the local URL in two tabs or browsers and use the same `?room=` query string to join the same poll.
 
-1. Open the app in multiple browser tabs/windows
+Example:
-2. **Create polls** from different tabs - they appear everywhere instantly
-3. **Add answer options** from different tabs to the same poll
-4. **Vote** from different tabs - watch vote counts update in real-time
-5. Try voting twice on the same option - it won't let you!
-6. Check the connection status indicator for peer count
-7. Verify visual feedback (green border) on options you've voted on
 
-## Development
+```text
-
+http://localhost:5173/?room=poll-demo
-### Backend Scripts
-- `npm run dev` - Start development server with hot reload
-- `npm run build` - Build for production
-- `npm start` - Run production build
-
-### Frontend Scripts
-- `npm run dev` - Start Vite dev server
-- `npm run build` - Build for production
-- `npm run preview` - Preview production build
-
-## Environment Variables
-
-### Backend (.env)
-```
-PORT=3000
-YJS_WS_PORT=1234
-NODE_ENV=development
-CORS_ORIGIN=http://localhost:5173
 ```
 
-### Frontend (.env)
+## Build
-```
+
-VITE_WS_URL=ws://localhost:3000
+```bash
+npm run build
 ```
 
-## Components
+## Notes
 
-### Frontend Components
+- The app uses public signaling through `y-webrtc` for MVP simplicity.
-- **PollView** - Main view showing all polls and create poll form
+- Poll state is not stored on an application server.
-- **CreatePoll** - Form to create new polls
+- WebRTC connectivity can still depend on the network environment of the participating peers.
-- **PollCard** - Individual poll display with metadata
-- **OptionList** - List of answer options with vote tracking
-- **AddOption** - Form to add new answer options
-- **VoteButton** - Vote button with disabled state for voted options
-- **ConnectionStatus** - Shows WebSocket and P2P connection status
-
-### Key Functions
-- `createPoll(question)` - Create a new poll
-- `addOption(pollId, text)` - Add an option to a specific poll
-- `vote(pollId, optionId)` - Vote on an option (one vote per user)
-- `hasVoted(option)` - Check if current user has voted on an option
-
-## User Tracking
-
-Each user gets a unique ID stored in localStorage:
-- Format: `user-xxxxxxxxx`
-- Used to track poll/option creators
-- Used to prevent duplicate voting
-- Persists across browser sessions
-
-## Future Enhancements
-
-- [ ] Edit/delete polls and options
-- [ ] User nicknames instead of IDs
-- [ ] Poll expiration/closing
-- [ ] Vote history and analytics
-- [ ] Export poll results
-- [ ] Persistent storage (database)
-- [ ] Dark mode toggle
-- [ ] Mobile responsive improvements
-- [ ] Poll categories/tags
-- [ ] Search/filter polls
-
-## License
-
-MIT

frontend/.env.example

@@ -1 +0,0 @@
-VITE_WS_URL=ws://localhost:3000

frontend/package.json

@@ -1,35 +0,0 @@
-{
-  "name": "p2p-poll-frontend",
-  "private": true,
-  "version": "1.0.0",
-  "type": "module",
-  "scripts": {
-    "dev": "vite",
-    "build": "tsc && vite build",
-    "preview": "vite preview",
-    "lint": "eslint . --ext ts,tsx --report-unused-disable-directives --max-warnings 0"
-  },
-  "dependencies": {
-    "react": "^18.2.0",
-    "react-dom": "^18.2.0",
-    "yjs": "^13.6.8",
-    "y-websocket": "^1.5.0",
-    "y-webrtc": "^10.2.5",
-    "lucide-react": "^0.294.0"
-  },
-  "devDependencies": {
-    "@types/react": "^18.2.37",
-    "@types/react-dom": "^18.2.15",
-    "@typescript-eslint/eslint-plugin": "^6.10.0",
-    "@typescript-eslint/parser": "^6.10.0",
-    "@vitejs/plugin-react": "^4.2.0",
-    "autoprefixer": "^10.4.16",
-    "eslint": "^8.53.0",
-    "eslint-plugin-react-hooks": "^4.6.0",
-    "eslint-plugin-react-refresh": "^0.4.4",
-    "postcss": "^8.4.31",
-    "tailwindcss": "^3.3.5",
-    "typescript": "^5.2.2",
-    "vite": "^5.0.0"
-  }
-}

frontend/postcss.config.js

@@ -1,6 +0,0 @@
-export default {
-  plugins: {
-    tailwindcss: {},
-    autoprefixer: {},
-  },
-}

frontend/src/App.tsx

@@ -1,8 +0,0 @@
-import { PollView } from './components/PollView';
-import './styles/index.css';
-
-function App() {
-  return <PollView />;
-}
-
-export default App;

frontend/src/components/AddOption.tsx

@@ -1,38 +0,0 @@
-import { useState } from 'react';
-import { Plus } from 'lucide-react';
-
-interface AddOptionProps {
-  onAdd: (text: string) => void;
-}
-
-export function AddOption({ onAdd }: AddOptionProps) {
-  const [text, setText] = useState('');
-
-  const handleSubmit = (e: React.FormEvent) => {
-    e.preventDefault();
-    if (text.trim()) {
-      onAdd(text);
-      setText('');
-    }
-  };
-
-  return (
-    <form onSubmit={handleSubmit} className="flex gap-2">
-      <input
-        type="text"
-        value={text}
-        onChange={(e) => setText(e.target.value)}
-        placeholder="Add a new option..."
-        className="flex-1 px-4 py-3 rounded-lg bg-white/10 border border-white/20 text-white placeholder-white/50 focus:outline-none focus:ring-2 focus:ring-white/30"
-      />
-      <button
-        type="submit"
-        disabled={!text.trim()}
-        className="px-6 py-3 bg-white text-purple-600 rounded-lg font-semibold hover:bg-white/90 disabled:opacity-50 disabled:cursor-not-allowed transition-all duration-200 flex items-center gap-2"
-      >
-        <Plus className="w-5 h-5" />
-        Add
-      </button>
-    </form>
-  );
-}

frontend/src/components/ConnectionStatus.tsx

@@ -1,34 +0,0 @@
-import { Wifi, WifiOff, Users } from 'lucide-react';
-
-interface ConnectionStatusProps {
-  isConnected: boolean;
-  wsProvider: any;
-  webrtcProvider: any;
-}
-
-export function ConnectionStatus({ isConnected, wsProvider, webrtcProvider }: ConnectionStatusProps) {
-  const peerCount = webrtcProvider?.room?.peers?.size || 0;
-
-  return (
-    <div className="flex items-center gap-4 text-white/90 text-sm">
-      <div className="flex items-center gap-2">
-        {isConnected ? (
-          <>
-            <Wifi className="w-4 h-4 text-green-400" />
-            <span>Connected</span>
-          </>
-        ) : (
-          <>
-            <WifiOff className="w-4 h-4 text-red-400" />
-            <span>Disconnected</span>
-          </>
-        )}
-      </div>
-      
-      <div className="flex items-center gap-2">
-        <Users className="w-4 h-4" />
-        <span>{peerCount} peer{peerCount !== 1 ? 's' : ''}</span>
-      </div>
-    </div>
-  );
-}

frontend/src/components/CreatePoll.tsx

@@ -1,43 +0,0 @@
-import { useState } from 'react';
-import { Plus } from 'lucide-react';
-
-interface CreatePollProps {
-  onCreate: (question: string) => void;
-}
-
-export function CreatePoll({ onCreate }: CreatePollProps) {
-  const [question, setQuestion] = useState('');
-
-  const handleSubmit = (e: React.FormEvent) => {
-    e.preventDefault();
-    if (question.trim()) {
-      onCreate(question);
-      setQuestion('');
-    }
-  };
-
-  return (
-    <form onSubmit={handleSubmit} className="mb-8">
-      <div className="bg-white/10 backdrop-blur-lg rounded-2xl shadow-2xl p-6 border border-white/20">
-        <h2 className="text-xl font-bold text-white mb-4">Create a New Poll</h2>
-        <div className="flex gap-2">
-          <input
-            type="text"
-            value={question}
-            onChange={(e) => setQuestion(e.target.value)}
-            placeholder="Enter your question..."
-            className="flex-1 px-4 py-3 rounded-lg bg-white/10 border border-white/20 text-white placeholder-white/50 focus:outline-none focus:ring-2 focus:ring-white/30"
-          />
-          <button
-            type="submit"
-            disabled={!question.trim()}
-            className="px-6 py-3 bg-white text-purple-600 rounded-lg font-semibold hover:bg-white/90 disabled:opacity-50 disabled:cursor-not-allowed transition-all duration-200 flex items-center gap-2"
-          >
-            <Plus className="w-5 h-5" />
-            Create Poll
-          </button>
-        </div>
-      </div>
-    </form>
-  );
-}

frontend/src/components/OptionList.tsx

@@ -1,60 +0,0 @@
-import { PollOption } from '../types/poll.types';
-import { VoteButton } from './VoteButton';
-
-interface OptionListProps {
-  options: PollOption[];
-  onVote: (optionId: string) => void;
-  hasVoted?: (option: PollOption) => boolean;
-}
-
-export function OptionList({ options, onVote, hasVoted }: OptionListProps) {
-  const totalVotes = options.reduce((sum, opt) => sum + opt.votes, 0);
-
-  const sortedOptions = [...options].sort((a, b) => b.votes - a.votes);
-
-  return (
-    <div className="space-y-3">
-      {sortedOptions.length === 0 ? (
-        <div className="text-center py-8 text-white/60">
-          No options yet. Add one to get started!
-        </div>
-      ) : (
-        sortedOptions.map((option) => {
-          const percentage = totalVotes > 0 ? (option.votes / totalVotes) * 100 : 0;
-          const userHasVoted = hasVoted ? hasVoted(option) : false;
-          
-          return (
-            <div
-              key={option.id}
-              className={`bg-white/10 backdrop-blur-sm rounded-lg p-4 border transition-all duration-200 ${
-                userHasVoted 
-                  ? 'border-green-400/50 bg-green-400/10' 
-                  : 'border-white/20 hover:border-white/30'
-              }`}
-            >
-              <div className="flex items-center justify-between mb-2">
-                <span className="text-white font-medium text-lg">
-                  {option.text}
-                  {userHasVoted && <span className="ml-2 text-green-400 text-sm">✓ Voted</span>}
-                </span>
-                <VoteButton optionId={option.id} votes={option.votes} onVote={onVote} disabled={userHasVoted} />
-              </div>
-              
-              <div className="w-full bg-white/10 rounded-full h-2 overflow-hidden">
-                <div
-                  className="bg-gradient-to-r from-green-400 to-blue-500 h-full transition-all duration-500 ease-out"
-                  style={{ width: `${percentage}%` }}
-                />
-              </div>
-              
-              <div className="mt-2 flex justify-between text-xs text-white/60">
-                <span>by {option.createdBy}</span>
-                <span>{percentage.toFixed(1)}%</span>
-              </div>
-            </div>
-          );
-        })
-      )}
-    </div>
-  );
-}

frontend/src/components/PollCard.tsx

@@ -1,50 +0,0 @@
-import { Poll } from '../types/poll.types';
-import { AddOption } from './AddOption';
-import { OptionList } from './OptionList';
-import { User, Clock } from 'lucide-react';
-
-interface PollCardProps {
-  poll: Poll;
-  onAddOption: (pollId: string, text: string) => void;
-  onVote: (pollId: string, optionId: string) => void;
-  hasVoted: (option: any) => boolean;
-}
-
-export function PollCard({ poll, onAddOption, onVote, hasVoted }: PollCardProps) {
-  const handleAddOption = (text: string) => {
-    onAddOption(poll.id, text);
-  };
-
-  const handleVote = (optionId: string) => {
-    onVote(poll.id, optionId);
-  };
-
-  const formatTime = (timestamp: number) => {
-    const date = new Date(timestamp);
-    return date.toLocaleString();
-  };
-
-  return (
-    <div className="bg-white/10 backdrop-blur-lg rounded-2xl shadow-2xl p-8 border border-white/20 mb-6">
-      <div className="mb-6">
-        <h2 className="text-3xl font-bold text-white mb-3">{poll.question}</h2>
-        <div className="flex items-center gap-4 text-white/60 text-sm">
-          <div className="flex items-center gap-1">
-            <User className="w-4 h-4" />
-            <span>{poll.createdBy}</span>
-          </div>
-          <div className="flex items-center gap-1">
-            <Clock className="w-4 h-4" />
-            <span>{formatTime(poll.timestamp)}</span>
-          </div>
-        </div>
-      </div>
-
-      <div className="mb-6">
-        <AddOption onAdd={handleAddOption} />
-      </div>
-
-      <OptionList options={poll.options} onVote={handleVote} hasVoted={hasVoted} />
-    </div>
-  );
-}

frontend/src/components/PollView.tsx

@@ -1,57 +0,0 @@
-import { RefreshCw } from 'lucide-react';
-import { usePoll } from '../hooks/usePoll';
-import { CreatePoll } from './CreatePoll';
-import { PollCard } from './PollCard';
-import { ConnectionStatus } from './ConnectionStatus';
-
-export function PollView() {
-  const { polls, createPoll, addOption, vote, hasVoted, isConnected, wsProvider, webrtcProvider } = usePoll();
-
-  return (
-    <div className="min-h-screen p-4 py-8">
-      <div className="max-w-4xl mx-auto">
-        <div className="mb-8 flex items-center justify-between">
-          <div>
-            <h1 className="text-4xl font-bold text-white mb-2">P2P Polling App</h1>
-            <p className="text-white/70">Create polls, add answers, and vote in real-time</p>
-          </div>
-          <ConnectionStatus 
-            isConnected={isConnected} 
-            wsProvider={wsProvider}
-            webrtcProvider={webrtcProvider}
-          />
-        </div>
-
-        <CreatePoll onCreate={createPoll} />
-
-        {polls.length === 0 ? (
-          <div className="bg-white/10 backdrop-blur-lg rounded-2xl shadow-2xl p-12 border border-white/20 text-center">
-            <p className="text-white/60 text-lg mb-2">No polls yet!</p>
-            <p className="text-white/40">Create the first poll to get started.</p>
-          </div>
-        ) : (
-          <div className="space-y-6">
-            {polls.map((poll) => (
-              <PollCard
-                key={poll.id}
-                poll={poll}
-                onAddOption={addOption}
-                onVote={vote}
-                hasVoted={hasVoted}
-              />
-            ))}
-          </div>
-        )}
-
-        <div className="mt-8 text-center text-white/50 text-sm">
-          <p>QUIC P2P Experiment !</p>
-          <p className="flex items-center justify-center gap-2 mt-1">
-            <RefreshCw className="w-4 h-4" />
-            Real-time P2P synchronization with Yjs
-          </p>
-          <p className="mt-1">Open multiple tabs to see live updates!</p>
-        </div>
-      </div>
-    </div>
-  );
-}

frontend/src/components/VoteButton.tsx

@@ -1,25 +0,0 @@
-import { ThumbsUp } from 'lucide-react';
-
-interface VoteButtonProps {
-  optionId: string;
-  votes: number;
-  onVote: (optionId: string) => void;
-  disabled?: boolean;
-}
-
-export function VoteButton({ optionId, votes, onVote, disabled = false }: VoteButtonProps) {
-  return (
-    <button
-      onClick={() => !disabled && onVote(optionId)}
-      disabled={disabled}
-      className={`flex items-center gap-2 px-4 py-2 rounded-lg transition-all duration-200 text-white font-medium ${
-        disabled 
-          ? 'bg-white/10 cursor-not-allowed opacity-60' 
-          : 'bg-white/20 hover:bg-white/30'
-      }`}
-    >
-      <ThumbsUp className="w-4 h-4" />
-      <span>{votes}</span>
-    </button>
-  );
-}

frontend/src/hooks/usePoll.ts

@@ -1,37 +0,0 @@
-import { useCallback } from 'react';
-import { pollManager } from '../lib/poll-manager';
-import { useYjsSync } from './useYjsSync';
-
-export function usePoll() {
-  const { polls, isConnected, wsProvider, webrtcProvider } = useYjsSync();
-
-  const createPoll = useCallback((question: string) => {
-    return pollManager.createPoll(question);
-  }, []);
-
-  const addOption = useCallback((pollId: string, text: string) => {
-    pollManager.addOption(pollId, text);
-  }, []);
-
-  const vote = useCallback((pollId: string, optionId: string) => {
-    pollManager.vote(pollId, optionId);
-  }, []);
-
-  const hasVoted = useCallback((option: any) => {
-    return pollManager.hasVoted(option);
-  }, []);
-
-  const userId = pollManager.getUserId();
-
-  return {
-    polls,
-    createPoll,
-    addOption,
-    vote,
-    hasVoted,
-    userId,
-    isConnected,
-    wsProvider,
-    webrtcProvider
-  };
-}

frontend/src/hooks/useYjsSync.ts

@@ -1,44 +0,0 @@
-import { useEffect, useState } from 'react';
-import { Poll } from '../types/poll.types';
-import { 
-  initializeProviders, 
-  destroyProviders, 
-  yPolls,
-  wsProvider,
-  webrtcProvider 
-} from '../lib/yjs-setup';
-
-export function useYjsSync() {
-  const [polls, setPolls] = useState<Poll[]>([]);
-  const [isConnected, setIsConnected] = useState(false);
-
-  useEffect(() => {
-    const { wsProvider: ws } = initializeProviders();
-
-    const updatePolls = () => {
-      setPolls([...yPolls.toArray()]);
-    };
-
-    yPolls.observe(updatePolls);
-    updatePolls();
-
-    const handleStatus = (event: { status: string }) => {
-      setIsConnected(event.status === 'connected');
-    };
-
-    ws?.on('status', handleStatus);
-
-    return () => {
-      yPolls.unobserve(updatePolls);
-      ws?.off('status', handleStatus);
-      destroyProviders();
-    };
-  }, []);
-
-  return { 
-    polls, 
-    isConnected,
-    wsProvider,
-    webrtcProvider
-  };
-}

frontend/src/lib/poll-manager.ts

@@ -1,43 +0,0 @@
-import { PollOption } from '../types/poll.types';
-import { createPoll as yjsCreatePoll, addOption as yjsAddOption, voteForOption as yjsVoteForOption } from './yjs-setup';
-
-export class PollManager {
-  private userId: string;
-
-  constructor() {
-    this.userId = this.generateUserId();
-  }
-
-  private generateUserId(): string {
-    const stored = localStorage.getItem('p2p-poll-user-id');
-    if (stored) return stored;
-    
-    const newId = 'user-' + Math.random().toString(36).substr(2, 9);
-    localStorage.setItem('p2p-poll-user-id', newId);
-    return newId;
-  }
-
-  getUserId(): string {
-    return this.userId;
-  }
-
-  createPoll(question: string): string {
-    if (!question.trim()) return '';
-    return yjsCreatePoll(question.trim(), this.userId);
-  }
-
-  addOption(pollId: string, text: string): void {
-    if (!text.trim()) return;
-    yjsAddOption(pollId, text.trim(), this.userId);
-  }
-
-  vote(pollId: string, optionId: string): void {
-    yjsVoteForOption(pollId, optionId, this.userId);
-  }
-
-  hasVoted(option: PollOption): boolean {
-    return option.votedBy.includes(this.userId);
-  }
-}
-
-export const pollManager = new PollManager();

frontend/src/lib/yjs-setup.ts

@@ -1,133 +0,0 @@
-import * as Y from 'yjs';
-import { WebsocketProvider } from 'y-websocket';
-import { WebrtcProvider } from 'y-webrtc';
-import { Poll, PollOption } from '../types/poll.types';
-
-const WS_URL = import.meta.env.VITE_WS_URL || 'ws://localhost:3000';
-const ROOM_NAME = 'default-poll';
-
-export const ydoc = new Y.Doc();
-
-export const yPolls = ydoc.getArray<Poll>('polls');
-
-export let wsProvider: WebsocketProvider | null = null;
-export let webrtcProvider: WebrtcProvider | null = null;
-
-export function initializeProviders() {
-  wsProvider = new WebsocketProvider(
-    WS_URL + '/yjs',
-    ROOM_NAME,
-    ydoc,
-    { connect: true }
-  );
-
-  webrtcProvider = new WebrtcProvider(
-    ROOM_NAME,
-    ydoc,
-    { 
-      signaling: [WS_URL.replace('ws://', 'wss://').replace('http://', 'https://') + '/signal'],
-      password: null,
-      awareness: wsProvider.awareness,
-      maxConns: 20,
-      filterBcConns: true,
-      peerOpts: {}
-    }
-  );
-
-  wsProvider.on('status', (event: { status: string }) => {
-    console.log('WebSocket status:', event.status);
-  });
-
-  webrtcProvider.on('synced', (synced: boolean) => {
-    console.log('WebRTC synced:', synced);
-  });
-
-  return { wsProvider, webrtcProvider };
-}
-
-export function destroyProviders() {
-  wsProvider?.destroy();
-  webrtcProvider?.destroy();
-}
-
-export function createPoll(question: string, createdBy: string): string {
-  const pollId = Math.random().toString(36).substr(2, 9);
-  const poll: Poll = {
-    id: pollId,
-    question,
-    createdBy,
-    timestamp: Date.now(),
-    options: []
-  };
-  
-  yPolls.push([poll]);
-  return pollId;
-}
-
-export function addOption(pollId: string, text: string, createdBy: string): void {
-  const polls = yPolls.toArray();
-  const pollIndex = polls.findIndex(p => p.id === pollId);
-  
-  if (pollIndex !== -1) {
-    const poll = polls[pollIndex];
-    const option: PollOption = {
-      id: Math.random().toString(36).substr(2, 9),
-      text,
-      votes: 0,
-      votedBy: [],
-      createdBy,
-      timestamp: Date.now()
-    };
-    
-    const updatedPoll = {
-      ...poll,
-      options: [...poll.options, option]
-    };
-    
-    yPolls.delete(pollIndex, 1);
-    yPolls.insert(pollIndex, [updatedPoll]);
-  }
-}
-
-export function voteForOption(pollId: string, optionId: string, userId: string): void {
-  const polls = yPolls.toArray();
-  const pollIndex = polls.findIndex(p => p.id === pollId);
-  
-  if (pollIndex !== -1) {
-    const poll = polls[pollIndex];
-    const optionIndex = poll.options.findIndex(opt => opt.id === optionId);
-    
-    if (optionIndex !== -1) {
-      const option = poll.options[optionIndex];
-      
-      if (option.votedBy.includes(userId)) {
-        return;
-      }
-      
-      const updatedOption = {
-        ...option,
-        votes: option.votes + 1,
-        votedBy: [...option.votedBy, userId]
-      };
-      
-      const updatedOptions = [...poll.options];
-      updatedOptions[optionIndex] = updatedOption;
-      
-      const updatedPoll = {
-        ...poll,
-        options: updatedOptions
-      };
-      
-      yPolls.delete(pollIndex, 1);
-      yPolls.insert(pollIndex, [updatedPoll]);
-    }
-  }
-}
-
-export function getPolls(): Poll[] {
-  return yPolls.toArray();
-}
-
-export function getPoll(pollId: string): Poll | undefined {
-  return yPolls.toArray().find(p => p.id === pollId);
-}

frontend/src/main.tsx

@@ -1,9 +0,0 @@
-import React from 'react';
-import ReactDOM from 'react-dom/client';
-import App from './App';
-
-ReactDOM.createRoot(document.getElementById('root')!).render(
-  <React.StrictMode>
-    <App />
-  </React.StrictMode>,
-);

frontend/src/styles/index.css

@@ -1,17 +0,0 @@
-@tailwind base;
-@tailwind components;
-@tailwind utilities;
-
-body {
-  margin: 0;
-  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen',
-    'Ubuntu', 'Cantarell', 'Fira Sans', 'Droid Sans', 'Helvetica Neue',
-    sans-serif;
-  -webkit-font-smoothing: antialiased;
-  -moz-osx-font-smoothing: grayscale;
-}
-
-#root {
-  min-height: 100vh;
-  background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
-}

frontend/src/types/poll.types.ts

@@ -1,22 +0,0 @@
-export interface PollOption {
-  id: string;
-  text: string;
-  votes: number;
-  votedBy: string[];
-  createdBy: string;
-  timestamp: number;
-}
-
-export interface Poll {
-  id: string;
-  question: string;
-  createdBy: string;
-  timestamp: number;
-  options: PollOption[];
-}
-
-export interface ConnectionStatus {
-  websocket: boolean;
-  webrtc: boolean;
-  peers: number;
-}

frontend/tailwind.config.js

@@ -1,11 +0,0 @@
-/** @type {import('tailwindcss').Config} */
-export default {
-  content: [
-    "./index.html",
-    "./src/**/*.{js,ts,jsx,tsx}",
-  ],
-  theme: {
-    extend: {},
-  },
-  plugins: [],
-}

frontend/tsconfig.json

@@ -1,21 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "useDefineForClassFields": true,
-    "lib": ["ES2020", "DOM", "DOM.Iterable"],
-    "module": "ESNext",
-    "skipLibCheck": true,
-    "moduleResolution": "bundler",
-    "allowImportingTsExtensions": true,
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "noEmit": true,
-    "jsx": "react-jsx",
-    "strict": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "noFallthroughCasesInSwitch": true
-  },
-  "include": ["src"],
-  "references": [{ "path": "./tsconfig.node.json" }]
-}

frontend/tsconfig.node.json

@@ -1,10 +0,0 @@
-{
-  "compilerOptions": {
-    "composite": true,
-    "skipLibCheck": true,
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "allowSyntheticDefaultImports": true
-  },
-  "include": ["vite.config.ts"]
-}

frontend/vite.config.ts

@@ -1,10 +0,0 @@
-import { defineConfig } from 'vite'
-import react from '@vitejs/plugin-react'
-
-export default defineConfig({
-  plugins: [react()],
-  server: {
-    port: 5173,
-    host: true
-  }
-})

index.html

@@ -2,12 +2,11 @@
 <html lang="en">
   <head>
     <meta charset="UTF-8" />
-    <link rel="icon" type="image/svg+xml" href="/vite.svg" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>P2P Poll App</title>
+    <title>P2P Poll</title>
   </head>
   <body>
-    <div id="root"></div>
+    <div id="app"></div>
-    <script type="module" src="/src/main.tsx"></script>
+    <script type="module" src="/src/main.ts"></script>
   </body>
 </html>

package.json

@@ -0,0 +1,20 @@
+{
+  "name": "p2p-poll-app",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc --noEmit && vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "y-indexeddb": "^9.0.12",
+    "y-webrtc": "^10.3.0",
+    "yjs": "^13.6.27"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.2",
+    "vite": "^7.1.5"
+  }
+}

server/.env.example

@@ -1,4 +0,0 @@
-PORT=3000
-YJS_WS_PORT=1234
-NODE_ENV=development
-CORS_ORIGIN=http://localhost:5173

server/.gitignore

@@ -1,5 +0,0 @@
-node_modules/
-dist/
-.env
-*.log
-.DS_Store

server/package.json

@@ -1,30 +0,0 @@
-{
-  "name": "p2p-poll-server",
-  "version": "1.0.0",
-  "description": "Backend server for P2P polling app with Yjs and WebRTC signaling",
-  "main": "dist/index.js",
-  "scripts": {
-    "dev": "tsx watch src/index.ts",
-    "build": "tsc",
-    "start": "node dist/index.js"
-  },
-  "keywords": ["yjs", "websocket", "webrtc", "p2p"],
-  "author": "",
-  "license": "MIT",
-  "dependencies": {
-    "express": "^4.18.2",
-    "ws": "^8.14.2",
-    "y-websocket": "^1.5.0",
-    "yjs": "^13.6.8",
-    "cors": "^2.8.5",
-    "dotenv": "^16.3.1"
-  },
-  "devDependencies": {
-    "@types/express": "^4.17.20",
-    "@types/ws": "^8.5.8",
-    "@types/cors": "^2.8.15",
-    "@types/node": "^20.9.0",
-    "tsx": "^4.6.2",
-    "typescript": "^5.2.2"
-  }
-}

server/src/index.ts

@@ -1,59 +0,0 @@
-import express from 'express';
-import http from 'http';
-import cors from 'cors';
-import dotenv from 'dotenv';
-import { createYjsServer } from './yjs-server';
-import { createSignalingServer } from './signaling-server';
-import { logger } from './utils/logger';
-
-dotenv.config();
-
-const app = express();
-const PORT = process.env.PORT || 3000;
-
-app.use(cors({
-  origin: process.env.CORS_ORIGIN || 'http://localhost:5173',
-  credentials: true
-}));
-
-app.use(express.json());
-
-app.get('/health', (req, res) => {
-  res.json({ 
-    status: 'ok', 
-    timestamp: new Date().toISOString(),
-    services: {
-      yjs: 'running',
-      signaling: 'running'
-    }
-  });
-});
-
-app.get('/', (req, res) => {
-  res.json({ 
-    message: 'P2P Poll Server',
-    endpoints: {
-      health: '/health',
-      yjs: 'ws://localhost:' + PORT + '/yjs',
-      signaling: 'ws://localhost:' + PORT + '/signal'
-    }
-  });
-});
-
-const server = http.createServer(app);
-
-createYjsServer(server, PORT as number);
-createSignalingServer(server);
-
-server.listen(PORT, () => {
-  logger.info(`Server running on port ${PORT}`);
-  logger.info(`Yjs WebSocket: ws://localhost:${PORT}/yjs`);
-  logger.info(`Signaling WebSocket: ws://localhost:${PORT}/signal`);
-});
-
-process.on('SIGTERM', () => {
-  logger.info('SIGTERM signal received: closing HTTP server');
-  server.close(() => {
-    logger.info('HTTP server closed');
-  });
-});

server/src/signaling-server.ts

@@ -1,126 +0,0 @@
-import { WebSocketServer, WebSocket } from 'ws';
-import http from 'http';
-import { SignalingMessage } from './types/poll.types';
-import { logger } from './utils/logger';
-
-interface Client {
-  id: string;
-  ws: WebSocket;
-  roomId: string;
-}
-
-export function createSignalingServer(server: http.Server) {
-  const wss = new WebSocketServer({ 
-    server,
-    path: '/signal'
-  });
-
-  const clients = new Map<string, Client>();
-  const rooms = new Map<string, Set<string>>();
-
-  wss.on('connection', (ws: WebSocket) => {
-    let clientId: string | null = null;
-
-    ws.on('message', (data: Buffer) => {
-      try {
-        const message: SignalingMessage = JSON.parse(data.toString());
-
-        switch (message.type) {
-          case 'join':
-            clientId = message.from;
-            const roomId = message.roomId || 'default-room';
-            
-            clients.set(clientId, { id: clientId, ws, roomId });
-            
-            if (!rooms.has(roomId)) {
-              rooms.set(roomId, new Set());
-            }
-            rooms.get(roomId)!.add(clientId);
-
-            logger.info(`Client ${clientId} joined room ${roomId}`);
-
-            const roomClients = Array.from(rooms.get(roomId)!).filter(id => id !== clientId);
-            ws.send(JSON.stringify({
-              type: 'peers',
-              peers: roomClients
-            }));
-
-            roomClients.forEach(peerId => {
-              const peer = clients.get(peerId);
-              if (peer && peer.ws.readyState === WebSocket.OPEN) {
-                peer.ws.send(JSON.stringify({
-                  type: 'peer-joined',
-                  peerId: clientId
-                }));
-              }
-            });
-            break;
-
-          case 'offer':
-          case 'answer':
-          case 'ice-candidate':
-            if (message.to) {
-              const targetClient = clients.get(message.to);
-              if (targetClient && targetClient.ws.readyState === WebSocket.OPEN) {
-                targetClient.ws.send(JSON.stringify({
-                  type: message.type,
-                  from: message.from,
-                  data: message.data
-                }));
-              }
-            }
-            break;
-
-          case 'leave':
-            handleClientLeave(message.from);
-            break;
-        }
-      } catch (error) {
-        logger.error('Error processing signaling message:', error);
-      }
-    });
-
-    ws.on('close', () => {
-      if (clientId) {
-        handleClientLeave(clientId);
-      }
-    });
-
-    ws.on('error', (error) => {
-      logger.error('WebSocket error:', error);
-    });
-  });
-
-  function handleClientLeave(clientId: string) {
-    const client = clients.get(clientId);
-    if (client) {
-      const roomId = client.roomId;
-      const room = rooms.get(roomId);
-      
-      if (room) {
-        room.delete(clientId);
-        
-        room.forEach(peerId => {
-          const peer = clients.get(peerId);
-          if (peer && peer.ws.readyState === WebSocket.OPEN) {
-            peer.ws.send(JSON.stringify({
-              type: 'peer-left',
-              peerId: clientId
-            }));
-          }
-        });
-
-        if (room.size === 0) {
-          rooms.delete(roomId);
-        }
-      }
-      
-      clients.delete(clientId);
-      logger.info(`Client ${clientId} left room ${roomId}`);
-    }
-  }
-
-  logger.info('Signaling server running at path /signal');
-  
-  return wss;
-}

server/src/types/poll.types.ts

@@ -1,24 +0,0 @@
-export interface PollOption {
-  id: string;
-  text: string;
-  votes: number;
-  votedBy: string[];
-  createdBy: string;
-  timestamp: number;
-}
-
-export interface Poll {
-  id: string;
-  question: string;
-  createdBy: string;
-  timestamp: number;
-  options: PollOption[];
-}
-
-export interface SignalingMessage {
-  type: 'offer' | 'answer' | 'ice-candidate' | 'join' | 'leave';
-  from: string;
-  to?: string;
-  data?: any;
-  roomId?: string;
-}

server/src/utils/logger.ts

@@ -1,16 +0,0 @@
-export const logger = {
-  info: (message: string, ...args: any[]) => {
-    console.log(`[INFO] ${new Date().toISOString()} - ${message}`, ...args);
-  },
-  error: (message: string, ...args: any[]) => {
-    console.error(`[ERROR] ${new Date().toISOString()} - ${message}`, ...args);
-  },
-  warn: (message: string, ...args: any[]) => {
-    console.warn(`[WARN] ${new Date().toISOString()} - ${message}`, ...args);
-  },
-  debug: (message: string, ...args: any[]) => {
-    if (process.env.NODE_ENV === 'development') {
-      console.debug(`[DEBUG] ${new Date().toISOString()} - ${message}`, ...args);
-    }
-  }
-};

server/src/yjs-server.ts

@@ -1,26 +0,0 @@
-import { WebSocketServer } from 'ws';
-import { setupWSConnection } from 'y-websocket/bin/utils';
-import http from 'http';
-import { logger } from './utils/logger';
-
-export function createYjsServer(server: http.Server, port: number) {
-  const wss = new WebSocketServer({ 
-    server,
-    path: '/yjs'
-  });
-
-  wss.on('connection', (ws, req) => {
-    const docName = req.url?.split('?')[1]?.split('=')[1] || 'default-poll';
-    logger.info(`New Yjs connection for document: ${docName}`);
-    
-    setupWSConnection(ws, req, { docName });
-  });
-
-  wss.on('error', (error) => {
-    logger.error('Yjs WebSocket server error:', error);
-  });
-
-  logger.info(`Yjs WebSocket server running on port ${port} at path /yjs`);
-  
-  return wss;
-}

server/tsconfig.json

@@ -1,20 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "commonjs",
-    "lib": ["ES2020"],
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true,
-    "moduleResolution": "node",
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}

src/app.ts

@@ -0,0 +1,107 @@
+import { getUserId } from "./identity";
+import { renderApp } from "./render";
+import { addOption, castVote, createViewModel } from "./state";
+import { initSync } from "./sync";
+
+const ROOM_PARAM = "room";
+
+function createRoomId() {
+  const seed = typeof crypto.randomUUID === "function"
+    ? crypto.randomUUID().slice(0, 8)
+    : Math.random().toString(36).slice(2, 10);
+
+  return `poll-${seed}`;
+}
+
+function ensureRoomId() {
+  const url = new URL(window.location.href);
+  let roomId = url.searchParams.get(ROOM_PARAM)?.trim();
+
+  if (!roomId) {
+    roomId = createRoomId();
+    url.searchParams.set(ROOM_PARAM, roomId);
+    window.history.replaceState({}, "", url);
+  }
+
+  return roomId;
+}
+
+export function initApp(container: HTMLElement) {
+  const roomId = ensureRoomId();
+  const userId = getUserId();
+  const sync = initSync(roomId);
+  let feedbackMessage = "Ready to collaborate.";
+  let feedbackTimer: number | undefined;
+
+  const setFeedbackMessage = (message: string) => {
+    feedbackMessage = message;
+    render();
+
+    if (feedbackTimer) {
+      window.clearTimeout(feedbackTimer);
+    }
+
+    feedbackTimer = window.setTimeout(() => {
+      feedbackMessage = "Ready to collaborate.";
+      render();
+    }, 2400);
+  };
+
+  const render = () => {
+    const viewModel = createViewModel({
+      meta: sync.meta,
+      options: sync.options,
+      votes: sync.votes,
+      roomId,
+      shareUrl: window.location.href,
+      connectionStatus: sync.getConnectionStatus(),
+      userId,
+    });
+
+    renderApp(container, viewModel, feedbackMessage, {
+      onSubmitOption: (label) => {
+        const result = addOption(sync.options, label, userId);
+        if (!result.ok) {
+          setFeedbackMessage(result.error);
+          return;
+        }
+
+        setFeedbackMessage("Option added and syncing.");
+      },
+      onVote: (optionId) => {
+        castVote(sync.votes, userId, optionId);
+        setFeedbackMessage("Vote updated.");
+      },
+      onCopyLink: async () => {
+        try {
+          await navigator.clipboard.writeText(window.location.href);
+          setFeedbackMessage("Room link copied.");
+        } catch {
+          setFeedbackMessage("Could not copy the link in this browser.");
+        }
+      },
+    });
+  };
+
+  const rerender = () => render();
+  const observe = () => rerender();
+
+  sync.doc.on("update", observe);
+  sync.persistence.once("synced", rerender);
+  sync.provider.on("status", rerender);
+  window.addEventListener("online", rerender);
+  window.addEventListener("offline", rerender);
+
+  render();
+
+  return () => {
+    if (feedbackTimer) {
+      window.clearTimeout(feedbackTimer);
+    }
+    sync.doc.off("update", observe);
+    sync.provider.off("status", rerender);
+    window.removeEventListener("online", rerender);
+    window.removeEventListener("offline", rerender);
+    sync.destroy();
+  };
+}

src/identity.ts

@@ -0,0 +1,20 @@
+const USER_ID_KEY = "p2p-poll:user-id";
+
+function createUserId() {
+  if (typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+
+  return `user-${Math.random().toString(36).slice(2, 10)}`;
+}
+
+export function getUserId() {
+  const existing = localStorage.getItem(USER_ID_KEY);
+  if (existing) {
+    return existing;
+  }
+
+  const next = createUserId();
+  localStorage.setItem(USER_ID_KEY, next);
+  return next;
+}

src/main.ts

@@ -0,0 +1,11 @@
+import "./styles.css";
+
+import { initApp } from "./app";
+
+const container = document.querySelector<HTMLElement>("#app");
+
+if (!container) {
+  throw new Error("App container not found.");
+}
+
+initApp(container);

src/render.ts

@@ -0,0 +1,131 @@
+import type { PollViewModel } from "./state";
+
+interface RenderActions {
+  onSubmitOption: (label: string) => void;
+  onVote: (optionId: string) => void;
+  onCopyLink: () => void;
+}
+
+function escapeHtml(value: string) {
+  return value
+    .replaceAll("&", "&")
+    .replaceAll("<", "&lt;")
+    .replaceAll(">", "&gt;")
+    .replaceAll('"', "&quot;")
+    .replaceAll("'", "&#39;");
+}
+
+export function renderApp(
+  container: HTMLElement,
+  viewModel: PollViewModel,
+  feedbackMessage: string,
+  actions: RenderActions,
+) {
+  const optionMarkup = viewModel.options.length
+    ? viewModel.options
+        .map((option) => {
+          const buttonLabel = option.isSelectedByMe ? "Selected" : "Vote";
+          const selectedClass = option.isSelectedByMe ? "option-card selected" : "option-card";
+
+          return `
+            <li class="${selectedClass}">
+              <div class="option-main">
+                <div>
+                  <p class="option-label">${escapeHtml(option.label)}</p>
+                  <p class="option-meta">${option.voteCount} vote${option.voteCount === 1 ? "" : "s"}</p>
+                </div>
+                <button class="vote-button" data-option-id="${option.id}">
+                  ${buttonLabel}
+                </button>
+              </div>
+            </li>
+          `;
+        })
+        .join("")
+    : `
+      <li class="empty-state">
+        No options yet. Add the first one and it will sync to everyone in this room.
+      </li>
+    `;
+
+  const statusClass = `status-pill ${viewModel.connectionStatus}`;
+  const myVoteLabel = viewModel.myVoteOptionId
+    ? "Your vote is currently synced."
+    : "You have not voted yet.";
+
+  container.innerHTML = `
+    <main class="shell">
+      <section class="hero">
+        <div class="hero-copy">
+          <p class="eyebrow">Peer-to-peer room</p>
+          <h1>${escapeHtml(viewModel.title)}</h1>
+          <p class="hero-text">
+            Share the room link, add options, and vote live without a central app server storing poll state.
+          </p>
+        </div>
+        <div class="hero-meta">
+          <span class="${statusClass}">${viewModel.connectionStatus}</span>
+          <p class="room-label">Room: <code>${escapeHtml(viewModel.roomId)}</code></p>
+        </div>
+      </section>
+
+      <section class="panel share-panel">
+        <label class="field-label" for="share-url">Share this room</label>
+        <div class="share-row">
+          <input id="share-url" class="share-input" type="text" readonly value="${escapeHtml(viewModel.shareUrl)}" />
+          <button id="copy-link-button" class="secondary-button" type="button">Copy link</button>
+        </div>
+      </section>
+
+      <section class="panel">
+        <div class="section-header">
+          <div>
+            <h2>Options</h2>
+            <p>${myVoteLabel}</p>
+          </div>
+        </div>
+        <ul class="options-list">${optionMarkup}</ul>
+      </section>
+
+      <section class="panel">
+        <h2>Add an option</h2>
+        <form id="add-option-form" class="option-form">
+          <input
+            id="option-input"
+            name="option"
+            type="text"
+            maxlength="80"
+            placeholder="Add an option"
+            autocomplete="off"
+            required
+          />
+          <button class="primary-button" type="submit">Add option</button>
+        </form>
+        <p class="feedback" aria-live="polite">${escapeHtml(feedbackMessage)}</p>
+      </section>
+    </main>
+  `;
+
+  const addOptionForm = container.querySelector<HTMLFormElement>("#add-option-form");
+  const optionInput = container.querySelector<HTMLInputElement>("#option-input");
+  const copyLinkButton = container.querySelector<HTMLButtonElement>("#copy-link-button");
+
+  addOptionForm?.addEventListener("submit", (event) => {
+    event.preventDefault();
+    const label = optionInput?.value ?? "";
+    actions.onSubmitOption(label);
+  });
+
+  copyLinkButton?.addEventListener("click", () => {
+    actions.onCopyLink();
+  });
+
+  container.querySelectorAll<HTMLButtonElement>("[data-option-id]").forEach((button) => {
+    button.addEventListener("click", () => {
+      const optionId = button.dataset.optionId;
+      if (optionId) {
+        actions.onVote(optionId);
+      }
+    });
+  });
+}

src/state.ts

@@ -0,0 +1,124 @@
+import * as Y from "yjs";
+
+export const DEFAULT_POLL_TITLE = "Shared Poll";
+
+export type ConnectionStatus = "connecting" | "connected" | "offline";
+
+export interface OptionRecord {
+  id: string;
+  label: string;
+  createdAt: number;
+  createdBy: string;
+}
+
+export interface PollOptionViewModel extends OptionRecord {
+  voteCount: number;
+  isSelectedByMe: boolean;
+}
+
+export interface PollViewModel {
+  title: string;
+  roomId: string;
+  shareUrl: string;
+  connectionStatus: ConnectionStatus;
+  options: PollOptionViewModel[];
+  myVoteOptionId: string | null;
+}
+
+const META_KEY_TITLE = "title";
+
+function createOptionId() {
+  if (typeof crypto.randomUUID === "function") {
+    return crypto.randomUUID();
+  }
+
+  return `option-${Math.random().toString(36).slice(2, 10)}`;
+}
+
+function normalizeLabel(label: string) {
+  return label.trim().replace(/\s+/g, " ");
+}
+
+function getPollTitle(meta: Y.Map<string>) {
+  return meta.get(META_KEY_TITLE) ?? DEFAULT_POLL_TITLE;
+}
+
+export function ensurePollInitialized(meta: Y.Map<string>) {
+  if (!meta.has(META_KEY_TITLE)) {
+    meta.set(META_KEY_TITLE, DEFAULT_POLL_TITLE);
+  }
+}
+
+export function addOption(
+  options: Y.Map<OptionRecord>,
+  rawLabel: string,
+  userId: string,
+) {
+  const label = normalizeLabel(rawLabel);
+  if (!label) {
+    return { ok: false as const, error: "Option label cannot be empty." };
+  }
+
+  const normalizedTarget = label.toLocaleLowerCase();
+  const duplicate = Array.from(options.values()).some(
+    (option) => option.label.trim().toLocaleLowerCase() === normalizedTarget,
+  );
+
+  if (duplicate) {
+    return { ok: false as const, error: "That option already exists." };
+  }
+
+  const option: OptionRecord = {
+    id: createOptionId(),
+    label,
+    createdAt: Date.now(),
+    createdBy: userId,
+  };
+
+  options.set(option.id, option);
+  return { ok: true as const, optionId: option.id };
+}
+
+export function castVote(votes: Y.Map<string>, userId: string, optionId: string) {
+  votes.set(userId, optionId);
+}
+
+export function createViewModel(params: {
+  meta: Y.Map<string>;
+  options: Y.Map<OptionRecord>;
+  votes: Y.Map<string>;
+  roomId: string;
+  shareUrl: string;
+  connectionStatus: ConnectionStatus;
+  userId: string;
+}): PollViewModel {
+  const { meta, options, votes, roomId, shareUrl, connectionStatus, userId } =
+    params;
+
+  const tally = new Map<string, number>();
+  for (const optionId of votes.values()) {
+    tally.set(optionId, (tally.get(optionId) ?? 0) + 1);
+  }
+
+  const myVoteOptionId = votes.get(userId) ?? null;
+  const sortedOptions = Array.from(options.values()).sort((left, right) => {
+    if (left.createdAt !== right.createdAt) {
+      return left.createdAt - right.createdAt;
+    }
+
+    return left.label.localeCompare(right.label);
+  });
+
+  return {
+    title: getPollTitle(meta),
+    roomId,
+    shareUrl,
+    connectionStatus,
+    myVoteOptionId,
+    options: sortedOptions.map((option) => ({
+      ...option,
+      voteCount: tally.get(option.id) ?? 0,
+      isSelectedByMe: myVoteOptionId === option.id,
+    })),
+  };
+}

src/styles.css

@@ -0,0 +1,256 @@
+:root {
+  font-family: "IBM Plex Sans", "Segoe UI", sans-serif;
+  color: #132238;
+  background:
+    radial-gradient(circle at top left, rgba(255, 190, 120, 0.55), transparent 28%),
+    radial-gradient(circle at top right, rgba(86, 201, 166, 0.3), transparent 24%),
+    linear-gradient(180deg, #f9f4e8 0%, #f4efe6 48%, #ece5d8 100%);
+  line-height: 1.5;
+  font-weight: 400;
+  color-scheme: light;
+}
+
+* {
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+  min-height: 100vh;
+}
+
+button,
+input {
+  font: inherit;
+}
+
+button {
+  cursor: pointer;
+}
+
+#app {
+  min-height: 100vh;
+}
+
+.shell {
+  width: min(920px, calc(100% - 2rem));
+  margin: 0 auto;
+  padding: 2rem 0 3rem;
+}
+
+.hero {
+  display: flex;
+  justify-content: space-between;
+  gap: 1.5rem;
+  align-items: flex-start;
+  margin-bottom: 1.5rem;
+}
+
+.hero-copy h1 {
+  margin: 0.15rem 0 0.5rem;
+  font-size: clamp(2.4rem, 6vw, 4rem);
+  line-height: 0.95;
+  letter-spacing: -0.05em;
+}
+
+.hero-text,
+.section-header p,
+.feedback,
+.option-meta,
+.room-label {
+  color: #4a5a6a;
+}
+
+.eyebrow {
+  margin: 0;
+  text-transform: uppercase;
+  letter-spacing: 0.16em;
+  font-size: 0.8rem;
+  color: #915f00;
+}
+
+.hero-meta {
+  min-width: 15rem;
+  padding: 1rem 1.1rem;
+  border-radius: 1.2rem;
+  background: rgba(255, 255, 255, 0.68);
+  border: 1px solid rgba(19, 34, 56, 0.08);
+  backdrop-filter: blur(10px);
+}
+
+.status-pill {
+  display: inline-flex;
+  align-items: center;
+  padding: 0.35rem 0.75rem;
+  border-radius: 999px;
+  font-weight: 700;
+  text-transform: capitalize;
+  font-size: 0.9rem;
+}
+
+.status-pill.connected {
+  background: rgba(86, 201, 166, 0.18);
+  color: #135d43;
+}
+
+.status-pill.connecting {
+  background: rgba(255, 190, 120, 0.22);
+  color: #8c5300;
+}
+
+.status-pill.offline {
+  background: rgba(219, 82, 82, 0.16);
+  color: #8f1f1f;
+}
+
+.panel {
+  margin-bottom: 1.25rem;
+  padding: 1.25rem;
+  border-radius: 1.3rem;
+  background: rgba(255, 255, 255, 0.78);
+  border: 1px solid rgba(19, 34, 56, 0.08);
+  box-shadow: 0 14px 40px rgba(19, 34, 56, 0.08);
+  backdrop-filter: blur(10px);
+}
+
+.panel h2 {
+  margin: 0 0 0.45rem;
+  font-size: 1.1rem;
+}
+
+.share-row,
+.option-form,
+.option-main {
+  display: flex;
+  gap: 0.75rem;
+}
+
+.field-label {
+  display: block;
+  margin-bottom: 0.6rem;
+  font-weight: 700;
+}
+
+.share-input,
+.option-form input {
+  width: 100%;
+  min-width: 0;
+  border-radius: 0.95rem;
+  border: 1px solid rgba(19, 34, 56, 0.14);
+  background: rgba(255, 255, 255, 0.94);
+  padding: 0.85rem 1rem;
+  color: #132238;
+}
+
+.share-input:focus,
+.option-form input:focus {
+  outline: 2px solid rgba(255, 190, 120, 0.65);
+  outline-offset: 1px;
+}
+
+.primary-button,
+.secondary-button,
+.vote-button {
+  border: none;
+  border-radius: 0.95rem;
+  padding: 0.85rem 1rem;
+  font-weight: 700;
+  transition: transform 150ms ease, box-shadow 150ms ease, background-color 150ms ease;
+}
+
+.primary-button,
+.vote-button {
+  background: #132238;
+  color: #f9f4e8;
+  box-shadow: 0 10px 20px rgba(19, 34, 56, 0.14);
+}
+
+.secondary-button {
+  background: rgba(19, 34, 56, 0.08);
+  color: #132238;
+}
+
+.primary-button:hover,
+.secondary-button:hover,
+.vote-button:hover {
+  transform: translateY(-1px);
+}
+
+.options-list {
+  list-style: none;
+  margin: 1rem 0 0;
+  padding: 0;
+  display: grid;
+  gap: 0.75rem;
+}
+
+.option-card,
+.empty-state {
+  border-radius: 1.1rem;
+  padding: 1rem;
+  background: rgba(247, 244, 236, 0.95);
+  border: 1px solid rgba(19, 34, 56, 0.08);
+}
+
+.option-card.selected {
+  border-color: rgba(86, 201, 166, 0.85);
+  background: rgba(232, 249, 242, 0.95);
+}
+
+.option-main {
+  align-items: center;
+  justify-content: space-between;
+}
+
+.option-label {
+  margin: 0;
+  font-size: 1.05rem;
+  font-weight: 700;
+}
+
+.option-meta,
+.feedback,
+.room-label {
+  margin: 0.35rem 0 0;
+}
+
+.section-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: baseline;
+  gap: 1rem;
+}
+
+.feedback {
+  min-height: 1.5rem;
+}
+
+code {
+  font-family: "IBM Plex Mono", "SFMono-Regular", monospace;
+}
+
+@media (max-width: 720px) {
+  .shell {
+    width: min(100% - 1rem, 920px);
+    padding-top: 1rem;
+  }
+
+  .hero,
+  .share-row,
+  .option-form,
+  .option-main,
+  .section-header {
+    flex-direction: column;
+  }
+
+  .hero-meta {
+    width: 100%;
+    min-width: 0;
+  }
+
+  .primary-button,
+  .secondary-button,
+  .vote-button {
+    width: 100%;
+  }
+}

src/sync.ts

@@ -0,0 +1,64 @@
+import { IndexeddbPersistence } from "y-indexeddb";
+import { WebrtcProvider } from "y-webrtc";
+import * as Y from "yjs";
+
+import { type ConnectionStatus, ensurePollInitialized, type OptionRecord } from "./state";
+
+export interface AppSync {
+  doc: Y.Doc;
+  meta: Y.Map<string>;
+  options: Y.Map<OptionRecord>;
+  votes: Y.Map<string>;
+  provider: WebrtcProvider;
+  persistence: IndexeddbPersistence;
+  getConnectionStatus: () => ConnectionStatus;
+  destroy: () => void;
+}
+
+export function initSync(roomId: string): AppSync {
+  const doc = new Y.Doc();
+  const meta = doc.getMap<string>("poll-meta");
+  const options = doc.getMap<OptionRecord>("poll-options");
+  const votes = doc.getMap<string>("poll-votes");
+
+  ensurePollInitialized(meta);
+
+  let connectionStatus: ConnectionStatus = navigator.onLine ? "connecting" : "offline";
+  const provider = new WebrtcProvider(roomId, doc);
+  const persistence = new IndexeddbPersistence(roomId, doc);
+
+  const syncConnectionStatus = (status: ConnectionStatus) => {
+    connectionStatus = navigator.onLine ? status : "offline";
+  };
+
+  const handleOnline = () => {
+    syncConnectionStatus(provider.connected ? "connected" : "connecting");
+  };
+  const handleOffline = () => {
+    connectionStatus = "offline";
+  };
+
+  provider.on("status", (event: { connected: boolean }) => {
+    syncConnectionStatus(event.connected ? "connected" : "connecting");
+  });
+
+  window.addEventListener("online", handleOnline);
+  window.addEventListener("offline", handleOffline);
+
+  return {
+    doc,
+    meta,
+    options,
+    votes,
+    provider,
+    persistence,
+    getConnectionStatus: () => connectionStatus,
+    destroy: () => {
+      window.removeEventListener("online", handleOnline);
+      window.removeEventListener("offline", handleOffline);
+      persistence.destroy();
+      provider.destroy();
+      doc.destroy();
+    },
+  };
+}

tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": ["DOM", "DOM.Iterable", "ES2022"],
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "allowSyntheticDefaultImports": true,
+    "useDefineForClassFields": true
+  },
+  "include": ["src"]
+}