Initial release of P2P Governance prototype

2026-03-15 12:19:02 +01:00
12 changed files with 236 additions and 10295 deletions
--- a/README.md
+++ b/README.md
@@ -1 +1,24 @@
-# P2P Poll App
+# 🗳️ Simple P2P Poll & Chat
 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.
 ## 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.
 ## 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.
--- a/index.html
+++ b/index.html
@@ -0,0 +1,212 @@
 <!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>
 </head>
 <body>
    <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>
        </div>
    </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>
        <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>
    <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>
                </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>
 </body>
 </html>
--- a/p2p-poll/.gitignore
+++ b/p2p-poll/.gitignore
@@ -1,24 +0,0 @@
 # Nuxt dev/build outputs
 .output
 .data
 .nuxt
 .nitro
 .cache
 dist
 # Node dependencies
 node_modules
 # Logs
 logs
 *.log
 # Misc
 .DS_Store
 .fleet
 .idea
 # Local env files
 .env
 .env.*
 !.env.example
--- a/p2p-poll/README.md
+++ b/p2p-poll/README.md
@@ -1,75 +0,0 @@
 # Nuxt Minimal Starter
 Look at the [Nuxt documentation](https://nuxt.com/docs/getting-started/introduction) to learn more.
 ## Setup
 Make sure to install dependencies:
 ```bash
 # npm
 npm install
 # pnpm
 pnpm install
 # yarn
 yarn install
 # bun
 bun install
 ```
 ## Development Server
 Start the development server on `http://localhost:3000`:
 ```bash
 # npm
 npm run dev
 # pnpm
 pnpm dev
 # yarn
 yarn dev
 # bun
 bun run dev
 ```
 ## Production
 Build the application for production:
 ```bash
 # npm
 npm run build
 # pnpm
 pnpm build
 # yarn
 yarn build
 # bun
 bun run build
 ```
 Locally preview production build:
 ```bash
 # npm
 npm run preview
 # pnpm
 pnpm preview
 # yarn
 yarn preview
 # bun
 bun run preview
 ```
 Check out the [deployment documentation](https://nuxt.com/docs/getting-started/deployment) for more information.
--- a/p2p-poll/app/app.vue
+++ b/p2p-poll/app/app.vue
@@ -1,152 +0,0 @@
 <style>
 /* Basic styling to make it look clean */
 body {
  font-family: system-ui, -apple-system, sans-serif;
  background-color: #f4f4f9;
  color: #333;
  margin: 0;
  display: flex;
  justify-content: center;
  padding: 2rem;
 }
 .poll-container {
  background: white;
  padding: 2rem;
  border-radius: 12px;
  box-shadow: 0 4px 6px rgba(0,0,0,0.1);
  width: 100%;
  max-width: 500px;
 }
 header {
  margin-bottom: 2rem;
  text-align: center;
 }
 h1 { margin: 0 0 0.5rem 0; }
 .status {
  font-size: 0.85rem;
  color: #666;
 }
 .status .connected { color: #10b981; font-weight: bold; }
 .add-option-form {
  display: flex;
  gap: 0.5rem;
  margin-bottom: 2rem;
 }
 input {
  flex-grow: 1;
  padding: 0.75rem;
  border: 1px solid #ccc;
  border-radius: 6px;
  font-size: 1rem;
 }
 button {
  background: #3b82f6;
  color: white;
  border: none;
  padding: 0.75rem 1rem;
  border-radius: 6px;
  cursor: pointer;
  font-weight: bold;
  transition: background 0.2s;
 }
 button:hover { background: #2563eb; }
 .poll-list {
  list-style: none;
  padding: 0;
  margin: 0;
 }
 .poll-item {
  display: flex;
  justify-content: space-between;
  align-items: center;
  padding: 1rem;
  background: #f8fafc;
  border: 1px solid #e2e8f0;
  border-radius: 8px;
  margin-bottom: 0.5rem;
 }
 .option-name { font-weight: 500; }
 .vote-section { display: flex; align-items: center; gap: 1rem; }
 .vote-count { font-size: 0.9rem; color: #475569; }
 .vote-btn { padding: 0.4rem 0.8rem; background: #10b981; }
 .vote-btn:hover { background: #059669; }
 .empty-state { text-align: center; color: #94a3b8; font-style: italic; }
 </style>
 <template>
  <div class="poll-container">
    <ClientOnly>
      <header>
        <h1>P2P Polling App 🗳️</h1>
        <div class="status">
          <span :class="{ 'connected': isConnected }">
            ● {{ isConnected ? 'Synced' : 'Connecting...' }}
          </span>
          <span> | Peers online: {{ connectedPeers }}</span>
        </div>
      </header>
      <main>
        <form @submit.prevent="handleAddNewOption" class="add-option-form">
          <input 
            v-model="newOption" 
            type="text" 
            placeholder="Enter a new poll option..."
            required
          />
          <button type="submit">Add Option</button>
        </form>
        <div v-if="Object.keys(pollData).length === 0" class="empty-state">
          No options yet. Be the first to add one!
        </div>
        <ul v-else class="poll-list">
          <li v-for="(votes, optionName) in pollData" :key="optionName" class="poll-item">
            <span class="option-name">{{ optionName }}</span>
            <div class="vote-section">
              <span class="vote-count">{{ votes }} {{ votes === 1 ? 'vote' : 'votes' }}</span>
              <button @click="vote(String(optionName))" class="vote-btn">+1</button>
            </div>
          </li>
        </ul>
      </main>
      <template #fallback>
        <div class="empty-state">Loading P2P Node...</div>
      </template>
    </ClientOnly>
  </div>
 </template>
 <script setup lang="ts">
 import { ref } from 'vue';
 // Manually define 'global' for the browser
 if (process.client) {
  (window as any).global = window;
 }
 import { usePoll } from '../composables/usePoll';
 // Because WebRTC requires the browser environment (window/navigator),
 // we ensure our composable only runs on the client side in Nuxt.
 const newOption = ref('');
 // Destructure our P2P logic
 const { pollData, isConnected, connectedPeers, addOption, vote } = usePoll();
 const handleAddNewOption = () => {
  addOption(newOption.value);
  newOption.value = ''; // Reset input
 };
 </script>
--- a/p2p-poll/composables/usePoll.ts
+++ b/p2p-poll/composables/usePoll.ts
@@ -1,81 +0,0 @@
 // composables/usePoll.ts
 import { ref, onMounted, onUnmounted } from 'vue';
 import * as Y from 'yjs';
 export const usePoll = () => {
  // Reactive Vue state to drive the UI
  const pollData = ref<Record<string, number>>({});
  const isConnected = ref(false);
  const connectedPeers = ref(1); // 1 = just you initially
  let ydoc: Y.Doc;
  let provider: any;
  let yMap: Y.Map<number>;
  onMounted(async () => {
    // 1. Initialize the Yjs document
    ydoc = new Y.Doc();
    // 2. Connect via WebRTC. 
    // 'nuxt-p2p-poll-demo-room' is the shared room name.
    // Anyone using this exact string will sync together.
    const { WebrtcProvider } = await import('y-webrtc');
    provider = new WebrtcProvider('nuxt-p2p-poll-demo-room', ydoc);
    // Track connection status
    provider.on('synced', (arg: {synced: boolean}) => {
      isConnected.value = arg.synced;
    });
    provider.on('peers', (data: any) => {
      // data.webrtcPeers contains the connected peer IDs
      connectedPeers.value = data.webrtcPeers.length + 1; // +1 for self
    });
    // 3. Define our shared state structure. We'll use a Map 
    // where the Key is the Poll Option (string) and Value is the Vote Count (number)
    yMap = ydoc.getMap<number>('shared-poll');
    // 4. Listen for changes from other peers and update our Vue reactive state
    yMap.observe(() => {
      pollData.value = yMap.toJSON();
    });
    // Initial load in case data already exists in the room
    pollData.value = yMap.toJSON();
  });
  onUnmounted(() => {
    // Clean up when the component is destroyed
    if (provider) {
      provider.disconnect();
    }
    if (ydoc) {
      ydoc.destroy();
    }
  });
  // Action: Add a new option to the poll
  const addOption = (optionName: string) => {
    const trimmedName = optionName.trim();
    if (trimmedName && !yMap.has(trimmedName)) {
      yMap.set(trimmedName, 0); // Initialize with 0 votes
    }
  };
  // Action: Vote for an existing option
  const vote = (optionName: string) => {
    if (yMap.has(optionName)) {
      const currentVotes = yMap.get(optionName) || 0;
      yMap.set(optionName, currentVotes + 1);
    }
  };
  return {
    pollData,
    isConnected,
    connectedPeers,
    addOption,
    vote
  };
 };
--- a/p2p-poll/nuxt.config.ts
+++ b/p2p-poll/nuxt.config.ts
@@ -1,11 +0,0 @@
 // https://nuxt.com/docs/api/configuration/nuxt-config
 export default defineNuxtConfig({
  compatibilityDate: '2025-07-15',
  devtools: { enabled: true },
  ssr: false,
  vite: {
    optimizeDeps: {
      include: ['yjs', 'y-webrtc']
    }
  }
 })
--- a/p2p-poll/package-lock.json
+++ b/p2p-poll/package-lock.json
--- a/p2p-poll/package.json
+++ b/p2p-poll/package.json
@@ -1,19 +0,0 @@
 {
  "name": "p2p-poll",
  "type": "module",
  "private": true,
  "scripts": {
    "build": "nuxt build",
    "dev": "nuxt dev",
    "generate": "nuxt generate",
    "preview": "nuxt preview",
    "postinstall": "nuxt prepare"
  },
  "dependencies": {
    "nuxt": "^4.1.3",
    "vue": "^3.5.30",
    "vue-router": "^5.0.3",
    "y-webrtc": "^10.3.0",
    "yjs": "^13.6.30"
  }
 }
--- a/p2p-poll/public/favicon.ico
+++ b/p2p-poll/public/favicon.ico
--- a/p2p-poll/public/robots.txt
+++ b/p2p-poll/public/robots.txt
@@ -1,2 +0,0 @@
 User-Agent: *
 Disallow:
--- a/p2p-poll/tsconfig.json
+++ b/p2p-poll/tsconfig.json
@@ -1,18 +0,0 @@
 {
  // https://nuxt.com/docs/guide/concepts/typescript
  "files": [],
  "references": [
    {
      "path": "./.nuxt/tsconfig.app.json"
    },
    {
      "path": "./.nuxt/tsconfig.server.json"
    },
    {
      "path": "./.nuxt/tsconfig.shared.json"
    },
    {
      "path": "./.nuxt/tsconfig.node.json"
    }
  ]
 }