Add initial implementation of P2P Poll app with HTML, CSS, and JavaScript

README.md

@@ -1,24 +1,14 @@
-# 🗳️ Simple P2P Poll & Chat
+# P2P Poll App
 
-This is a minimal prototype of a decentralized governance tool built for the **Demcode Evocracy** experiment. It allows for basic deliberation and voting without a central database or server-side logic.
+P2P Poll - Minimal GUN-based Scaffolding
 
-## What it does
-- **P2P Connectivity:** Uses WebRTC (via PeerJS) to link browsers directly.
-- **Mesh-capable:** Allows multiple connections to sync the same poll state.
-- **Live Sync:** Changes to the poll topic, options, or votes are broadcast to all connected peers.
-- **Chat:** A simple sidebar to discuss the poll in real-time.
+What this is
+- A tiny peer-to-peer polling app implemented with vanilla JS and GUN (a decentralized, CRDT-friendly database).
+- No central server for poll data. Peers connect and synchronize the poll in real-time.
 
-## How to use it
-1. Open the page: [https://andrewlehr.github.io/evocracy-p2p-poll/]
-2. Set your **Nickname** and click "Set".
-3. Share your nickname with a friend.
-4. One person enters the other's nickname in the **Connect** box and clicks "Add Peer".
-5. Once connected, you can set a topic, add options, and vote.
-
-## Technical Notes
-- **Data Persistence:** There is no database. If everyone closes their browser, the data is lost.
-- **Networking:** It uses a public signaling server to find peers, but the actual data (votes/chat) stays between the browsers.
-- **Conflict Handling:** Uses a simple "Last Write Wins" broadcast to keep peers in sync.
-
-## Transparency
-This code was generated with the assistance of **Gemini (Google AI)** to quickly prototype the WebRTC networking logic. The goal was to create a clean, readable foundation that is easy for others to merge or modify during the next phase of the experiment.
+Notes
+- This scaffold uses GUN’s browser-based peer-to-peer data replication.
+- You can extend with:
+  - Persistent storage on each peer
+  - Better conflict resolution UI
+  - Optional signaling server for explicit peer discovery

app.js

@@ -0,0 +1,200 @@
+// Minimal GUN-based P2P Poll scaffold (vanilla JS)
+
+(function() {
+  // Initialize GUN (no server needed; can optionally connect to a relay server)
+  // If you want a local-only node for prototyping: Gun()
+  // If you want to use a signaling server for discovery, pass a list of peers to Gun().opt({peers: [...]})
+  const gun = Gun();
+
+  // DOM helpers
+  const pollSection = document.getElementById('poll');
+  const pollIdInput = document.getElementById('pollId');
+  const loadPollBtn = document.getElementById('loadPollBtn');
+  const createPollBtn = document.getElementById('createPollBtn');
+  const pollTitleInput = document.getElementById('pollTitle');
+  const setTitleBtn = document.getElementById('setTitleBtn');
+  const optionsDiv = document.getElementById('options');
+  const newOptionInput = document.getElementById('newOption');
+  const addOptionBtn = document.getElementById('addOptionBtn');
+  const totalVotesSpan = document.getElementById('totalVotes');
+  const pollIdDisplay = document.getElementById('pollIdDisplay');
+
+  let currentPollId = null;
+  let pollsRef = null; // Gun node for /polls/{pollId}
+  let pollData = null; // local cache
+
+  // Helpers
+  function renderOptionList(options) {
+    optionsDiv.innerHTML = '';
+    const keys = Object.keys(options || {});
+    if (keys.length === 0) {
+      optionsDiv.innerHTML = '<p>No options yet. Add one below.</p>';
+      return;
+    }
+    keys.forEach((optId) => {
+      const opt = options[optId];
+      const el = document.createElement('div');
+      el.className = 'option';
+      el.innerHTML = `
+        <span class="text">${opt.text}</span>
+        <button data-optid="${optId}" class="voteBtn">Vote (${opt.votes || 0})</button>
+      `;
+      optionsDiv.appendChild(el);
+    });
+  }
+
+  function updateTotalVotes() {
+    const opts = pollData && pollData.options ? pollData.options : {};
+    const total = Object.values(opts).reduce((sum, o) => sum + (o.votes || 0), 0);
+    totalVotesSpan.textContent = total;
+  }
+
+  // Load existing poll and subscribe to changes
+  function loadPoll(pollId) {
+    if (!pollId) return;
+
+    currentPollId = pollId;
+    pollIdDisplay.textContent = pollId;
+    pollsRef = gun.get('polls').get(pollId);
+
+    // Initialize structure if new poll
+    pollsRef.get('title').put('Untitled Poll');
+    pollsRef.get('options').put({}); // ensure map exists
+
+    // Real-time updates: listen to changes
+    pollsRef.get('title').on((title) => {
+      pollTitleInput.value = title || '';
+    });
+
+    pollsRef.on((data) => {
+      // data is the entire poll node if subscribed; but we explore explicit fields
+    });
+
+    // For options map
+    pollsRef.get('options').on((opts) => {
+      // opts is the entire options map; convert to plain object
+      const optionsObj = toPlainObject(opts);
+      pollData = {
+        title: null,
+        options: optionsObj
+      };
+      renderOptionList(optionsObj);
+      updateTotalVotes();
+    });
+
+    // Also listen for title changes separately (in case some clients push via title path)
+    pollsRef.get('title').on((title) => {
+      pollTitleInput.value = title || '';
+    });
+
+    // Show UI
+    document.getElementById('setup').style.display = 'none';
+    pollSection.style.display = 'block';
+  }
+
+  // Create a new poll
+  function createPoll() {
+    const pollId = pollIdInput.value.trim();
+    if (!pollId) {
+      alert('Please enter a poll ID to create.');
+      return;
+    }
+    currentPollId = pollId;
+    // Initialize poll
+    pollsRef = gun.get('polls').get(pollId);
+    pollsRef.put({
+      title: 'New Poll',
+    });
+    pollsRef.get('options').put({}); // ensure map exists
+    // reflect in UI
+    pollIdDisplay.textContent = pollId;
+    pollTitleInput.value = 'New Poll';
+    pollSection.style.display = 'block';
+    document.getElementById('setup').style.display = 'none';
+  }
+
+  // Add option
+  function addOption() {
+    if (!pollsRef) {
+      alert('Load or create a poll first.');
+      return;
+    }
+    const text = newOptionInput.value.trim();
+    if (!text) return;
+    const optionId = 'opt_' + Date.now();
+    pollsRef.get('options').get(optionId).put({ text, votes: 0 });
+    newOptionInput.value = '';
+  }
+
+  // Set title
+  function setTitle() {
+    if (!pollsRef) return;
+    const title = pollTitleInput.value.trim() || 'Untitled';
+    pollsRef.get('title').put(title);
+  }
+
+  // Vote handler (delegated)
+  function handleVoteClick(e) {
+    if (e.target.classList.contains('voteBtn')) {
+      const optId = e.target.getAttribute('data-optid');
+      if (!optId || !pollsRef) return;
+      const optRef = pollsRef.get('options').get(optId);
+      // Increment votes locally
+      optRef.get('votes').once((v) => {
+        const current = v || 0;
+        optRef.put({ votes: current + 1 });
+      });
+      // UI will update via the on() listener on options map
+    }
+  }
+
+  // Utilities
+  function toPlainObject(obj) {
+    // Gun emits special proxy-like objects; convert to plain object
+    if (!obj) return {};
+    // If it's already a plain object, return
+    if (typeof obj !== 'object') return {};
+    // Gun events deliver object-like; attempt shallow copy
+    try {
+      const copy = JSON.parse(JSON.stringify(obj));
+      return copy;
+    } catch (e) {
+      // Fallback: return as-is if cannot stringify
+      return obj;
+    }
+  }
+
+  // Event bindings
+  loadPollBtn.addEventListener('click', () => {
+    const id = pollIdInput.value.trim();
+    if (!id) {
+      alert('Enter a Poll ID to load.');
+      return;
+    }
+    loadPoll(id);
+  });
+
+  createPollBtn.addEventListener('click', () => {
+    createPoll();
+  });
+
+  addOptionBtn.addEventListener('click', addOption);
+  newOptionInput.addEventListener('keydown', (ev) => {
+    if (ev.key === 'Enter') addOption();
+  });
+
+  setTitleBtn.addEventListener('click', setTitle);
+
+  // Delegate vote clicks
+  optionsDiv.addEventListener('click', handleVoteClick);
+
+  // Initialize: optionally auto-create a poll if URL param present
+  // Example: ?pollId=my-poll-123
+  const urlParams = new URLSearchParams(window.location.search);
+  const autoPoll = urlParams.get('pollId');
+  if (autoPoll) {
+    pollIdInput.value = autoPoll;
+    loadPoll(autoPoll);
+  }
+
+})();

index.html

@@ -1,212 +1,55 @@
-<!DOCTYPE html>
+<!doctype html>
 <html lang="en">
 <head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=no">
-    <title>Mesh Governance Tool</title>
-    <script src="https://unpkg.com/peerjs@1.5.2/dist/peerjs.min.js"></script>
-    <style>
-        :root { --primary: #007AFF; --bg: #f2f2f7; --success: #34c759; --secondary: #8e8e93; }
-        * { box-sizing: border-box; }
-        body { font-family: -apple-system, sans-serif; margin: 0; background: var(--bg); height: 100vh; display: flex; flex-direction: column; overflow: hidden; }
-        
-        /* Header & Peer List */
-        .header { background: #fff; padding: 12px; border-bottom: 1px solid #d1d1d6; flex-shrink: 0; }
-        .setup-row { display: flex; gap: 8px; margin-bottom: 10px; align-items: center; }
-        .peer-list-container { display: flex; gap: 6px; overflow-x: auto; padding-bottom: 4px; scrollbar-width: none; }
-        .peer-list-container::-webkit-scrollbar { display: none; }
-        .peer-chip { background: #e9ecef; padding: 4px 10px; border-radius: 12px; font-size: 11px; white-space: nowrap; border: 1px solid #dee2e6; display: flex; align-items: center; gap: 5px; }
-        .dot { width: 6px; height: 6px; background: var(--success); border-radius: 50%; }
-
-        /* Main Layout */
-        .main-container { display: flex; flex: 1; overflow: hidden; }
-        @media (max-width: 768px) { .main-container { flex-direction: column; } }
-        .column { flex: 1; display: flex; flex-direction: column; overflow: hidden; background: #fff; border-right: 1px solid #d1d1d6; }
-        .scroll-area { flex: 1; overflow-y: auto; padding: 16px; -webkit-overflow-scrolling: touch; }
-
-        /* Components */
-        .card { background: #f9f9f9; border-radius: 10px; padding: 12px; margin-bottom: 15px; border: 1px solid #e5e5ea; }
-        input { border: 1px solid #c6c6c8; padding: 10px; border-radius: 8px; font-size: 16px; width: 100%; outline: none; }
-        button { background: var(--primary); color: white; border: none; padding: 10px; border-radius: 8px; font-weight: 600; cursor: pointer; }
-        
-        /* Poll UI */
-        .poll-question { font-size: 20px; font-weight: 700; margin-bottom: 15px; color: var(--primary); }
-        .option-item { display: flex; justify-content: space-between; align-items: center; background: white; padding: 12px; border-radius: 10px; margin-bottom: 8px; border: 1px solid #e5e5ea; }
-        
-        /* Chat UI */
-        #chat-messages { display: flex; flex-direction: column; gap: 8px; }
-        .msg { padding: 8px 12px; border-radius: 14px; max-width: 85%; font-size: 14px; }
-        .msg.sent { background: var(--primary); color: white; align-self: flex-end; }
-        .msg.received { background: #e5e5ea; color: black; align-self: flex-start; }
-        .msg-sender { font-size: 10px; font-weight: bold; opacity: 0.7; display: block; }
-        .chat-input-bar { padding: 12px; background: #fff; border-top: 1px solid #d1d1d6; display: flex; gap: 8px; padding-bottom: calc(12px + env(safe-area-inset-bottom)); }
-    </style>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
+  <title>P2P Poll</title>
+  <link rel="stylesheet" href="styles.css" />
+  <!-- Gun.js via CDN for quick start -->
+  <script src="https://unpkg.com/gun/gun.js"></script>
 </head>
 <body>
+  <div class="container">
+    <h1>P2P Poll</h1>
 
-    <div class="header">
-        <div class="setup-row">
-            <span style="font-size: 13px;">Me: <strong id="my-id-display">...</strong></span>
-            <div id="peer-list" class="peer-list-container">
-                </div>
-        </div>
-        <div class="setup-row">
-            <input type="text" id="nickname-input" placeholder="My Name" style="flex: 0.5;">
-            <button onclick="joinAs(document.getElementById('nickname-input').value)" style="background: var(--secondary); padding: 8px 12px;">Set</button>
-            <input type="text" id="peer-id-input" placeholder="Friend's Name" style="flex: 1;">
-            <button onclick="connectToPeer()" style="padding: 8px 12px;">Connect</button>
+    <section id="setup" class="card">
+      <h2>Start or Join Poll</h2>
+      <div class="field">
+        <label for="pollId">Poll ID (share with peer):</label>
+        <input id="pollId" type="text" placeholder="e.g. my-poll-123" />
       </div>
+      <button id="loadPollBtn">Load Poll</button>
+      <button id="createPollBtn">Create New Poll</button>
+      <p class="note">Tip: You can run two instances and connect by using the same Poll ID.</p>
+    </section>
+
+    <section id="poll" class="card" style="display:none;">
+      <h2>Poll</h2>
+      <div class="field">
+        <label for="pollTitle">Poll Title</label>
+        <input id="pollTitle" type="text" placeholder="Poll Title" />
+        <button id="setTitleBtn">Set Title</button>
       </div>
 
-    <div class="main-container">
-        <div class="column">
-            <div class="scroll-area">
-                <div class="card">
-                    <input type="text" id="poll-title-input" placeholder="Question/Topic?">
-                    <button onclick="updateTitle()" style="width:100%; margin-top:8px;">Set Topic</button>
-                </div>
-                <div id="active-question" class="poll-question">Waiting for Topic...</div>
-                <div style="display:flex; gap:8px; margin-bottom:15px;">
-                    <input type="text" id="new-option-text" placeholder="Add option...">
-                    <button onclick="addOption()">Add</button>
-                </div>
-                <div id="poll-container"></div>
-            </div>
+      <div id="options" class="options">
+        <!-- dynamic options will render here -->
       </div>
 
-        <div class="column">
-            <div class="scroll-area" id="chat-scroll">
-                <div id="chat-messages"></div>
-            </div>
-            <div class="chat-input-bar">
-                <input type="text" id="chat-input" placeholder="Discuss...">
-                <button onclick="sendMessage()">Send</button>
-            </div>
-        </div>
+      <div class="field">
+        <input id="newOption" type="text" placeholder="Add a new option" />
+        <button id="addOptionBtn">Add Option</button>
       </div>
 
-    <script>
-        let pollData = { question: "Open Discussion", options: [] };
-        let myName = "";
-        let connections = []; 
-        let peer = null;
-
-        function joinAs(id) {
-            if (peer) peer.destroy();
-            peer = new Peer(id || undefined);
-            peer.on('open', newId => { 
-                myName = newId; 
-                document.getElementById('my-id-display').innerText = newId; 
-            });
-            peer.on('connection', conn => setupConnection(conn));
-        }
-
-        function connectToPeer() {
-            const target = document.getElementById('peer-id-input').value;
-            if (target && target !== myName) {
-                setupConnection(peer.connect(target));
-            }
-            document.getElementById('peer-id-input').value = "";
-        }
-
-        function setupConnection(conn) {
-            conn.on('open', () => {
-                // Prevent duplicate connections
-                if (!connections.find(c => c.peer === conn.peer)) {
-                    connections.push(conn);
-                    updatePeerUI();
-                    broadcast({ type: 'SYNC', payload: pollData });
-                }
-            });
-
-            conn.on('data', data => {
-                if (data.type === 'SYNC') {
-                    pollData = data.payload;
-                    renderPoll();
-                } else if (data.type === 'CHAT') {
-                    appendMessage(data.sender, data.payload, 'received');
-                }
-            });
-
-            conn.on('close', () => {
-                connections = connections.filter(c => c.peer !== conn.peer);
-                updatePeerUI();
-            });
-        }
-
-        function broadcast(data) {
-            connections.forEach(c => { if (c.open) c.send(data); });
-        }
-
-        function updatePeerUI() {
-            const list = document.getElementById('peer-list');
-            if (connections.length === 0) {
-                list.innerHTML = '<span style="font-size:11px; color:#999;">No peers connected</span>';
-                return;
-            }
-            list.innerHTML = connections.map(c => `
-                <div class="peer-chip"><div class="dot"></div>${c.peer}</div>
-            `).join('');
-        }
-
-        // --- APP LOGIC ---
-        function updateTitle() {
-            const val = document.getElementById('poll-title-input').value;
-            if (!val) return;
-            pollData.question = val;
-            renderPoll();
-            broadcast({ type: 'SYNC', payload: pollData });
-        }
-
-        function addOption() {
-            const txt = document.getElementById('new-option-text').value;
-            if (!txt) return;
-            pollData.options.push({ text: txt, votes: 0 });
-            document.getElementById('new-option-text').value = "";
-            renderPoll();
-            broadcast({ type: 'SYNC', payload: pollData });
-        }
-
-        function vote(i) {
-            pollData.options[i].votes++;
-            renderPoll();
-            broadcast({ type: 'SYNC', payload: pollData });
-        }
-
-        function renderPoll() {
-            document.getElementById('active-question').innerText = pollData.question;
-            const container = document.getElementById('poll-container');
-            container.innerHTML = pollData.options.map((opt, i) => `
-                <div class="option-item">
-                    <span>${opt.text}</span>
-                    <div style="display:flex; align-items:center;">
-                        <span style="font-weight:bold; color:var(--primary); margin-right:12px; font-size:18px;">${opt.votes}</span>
-                        <button onclick="vote(${i})" style="background:var(--success); padding:5px 12px;">Vote</button>
+      <div class="summary">
+        <p>Total votes: <span id="totalVotes">0</span></p>
       </div>
+
+      <div class="share">
+        <p>Share Poll ID with peer: <code id="pollIdDisplay"></code></p>
+      </div>
+    </section>
   </div>
-            `).join('');
-        }
 
-        function sendMessage() {
-            const input = document.getElementById('chat-input');
-            if (!input.value) return;
-            broadcast({ type: 'CHAT', sender: myName, payload: input.value });
-            appendMessage('You', input.value, 'sent');
-            input.value = "";
-        }
-
-        function appendMessage(sender, text, side) {
-            const div = document.createElement('div');
-            div.className = `msg ${side}`;
-            div.innerHTML = `<span class="msg-sender">${sender}</span>${text}`;
-            document.getElementById('chat-messages').appendChild(div);
-            const scroll = document.getElementById('chat-scroll');
-            scroll.scrollTop = scroll.scrollHeight;
-        }
-
-        document.getElementById('chat-input').addEventListener('keypress', (e) => { if (e.key === 'Enter') sendMessage(); });
-
-        joinAs(null);
-    </script>
+  <script src="app.js"></script>
 </body>
 </html>

styles.css

@@ -0,0 +1,104 @@
+:root {
+    --bg: #0f1220;
+    --card: #1a1740;
+    --text: #e8e3ff;
+    --muted: #b8a7d2;
+    --accent: #6bd3ff;
+}
+
+* {
+    box-sizing: border-box;
+}
+
+html,
+body {
+    margin: 0;
+    padding: 0;
+    font-family: sans-serif;
+    background: #0b0a14;
+    color: #fff;
+    height: 100%;
+}
+
+.container {
+    max-width: 700px;
+    margin: 40px auto;
+    padding: 0 16px;
+}
+
+.card {
+    background: #1f1740;
+    border-radius: 12px;
+    padding: 16px;
+    margin-bottom: 14px;
+    border: 1px solid #2a1950;
+}
+
+.field {
+    margin-bottom: 12px;
+    display: flex;
+    gap: 8px;
+    align-items: center;
+}
+
+label {
+    min-width: 180px;
+}
+
+input[type="text"] {
+    flex: 1;
+    padding: 8px;
+    border-radius: 6px;
+    border: 1px solid #5a2d8a;
+    background: #2a174f;
+    color: #fff;
+}
+
+button {
+    padding: 8px 12px;
+    border-radius: 6px;
+    border: none;
+    background: #6bd3ff;
+    color: #04152a;
+    font-weight: bold;
+    cursor: pointer;
+}
+
+button:hover {
+    opacity: 0.95;
+}
+
+.options {
+    display: flex;
+    flex-direction: column;
+    gap: 8px;
+    margin-top: 6px;
+}
+
+.option {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    padding: 8px;
+    background: #2a174f;
+    border: 1px solid #40217a;
+    border-radius: 6px;
+}
+
+.option .text {
+    flex: 1;
+}
+
+.share {
+    font-size: 0.9em;
+    color: var(--muted);
+}
+
+.note {
+    color: #c8b5ff;
+    font-size: 0.9em;
+}
+
+.total {
+    font-weight: bold;
+}