📊

The Big Board

Live Election Command Center
Healthy
Syncing in 10s
"Tracking key battlegrounds, county returns, and margin swings nationwide..." National & Local Feeds Aggregated
🗺️ 50-State & District Explorer:
Scope:
Monitored Contests
0
Across 0 sources
Declared Winners
0
0% called
Total Ballots Counted
0
Aggregated across all feeds
Avg Precinct Reporting
0.0%
0 / 0 precincts

🔄 Seats Flipped Tracker

Net party control changes across National, Statewide, and Local contests
🇺🇸 National (Senate & House) 0 Flips
Net: No Shift
0 Dem flips • 0 Rep flips
🏛️ State (Gov & Legislature) 0 Flips
Net: No Shift
0 Dem flips • 0 Rep flips
📍 Local & Municipal 0 Flips
Net: No Shift
0 Dem flips • 0 Rep flips
DEM Lead / Call REP Lead / Call ⭐ Tracked 🚨 Seat Flip
💬 LIVE FEED Waiting for live ballot drops and race call alerts...
Loading live election data...

💬 Live Election Alert Feed LIVE STREAM

Real-time stream of every ballot drop, lead change, race call, and analytical math update broadcast by Election Watcher.

Filter Stream:
Loading live alert feed...

⚡ Multi-Network National & 50-State Feed Switchboard

Current Mode: National & 50-State Stack (9 Feeds Active)

One-click scraper mode switchboard. The default National & 50-State Stack (9 Feeds) aggregates AP/NYT, NBC News Decision Desk, and CNN/Edison NEP across all U.S. Senate, U.S. Governor, and U.S. House contests nationwide. Local/county scrapers are modularized under Phase 2.

Target Feed Sources (National, Statewide & Subscribed States)

Configure automated election scrapers and APIs across national (U.S. Senate, U.S. House), state (U.S. Governor, State Legislatures), and optional Phase 2 local feeds. Use "Test Feed" to verify HTTP status and contest discovery.

ID Source Name & Live Status Tier Adapter Interval Endpoint URL Actions

Core Engine Settings

Alert Channels (MQTT & Homelab)

📖 How-To Runbook: Special Elections & Next Election Season Rollover

Admin Operations Guide

Quick-reference checklist for reusing The Big Board for an off-cycle Special Election (UI-only, under 2 minutes) or rolling over to the Next Full General Election Cycle (e.g., Nov 2027 or Nov 2028).

⚡ Option A: Special Election Setup (UI Only, No Code Changes)
  1. Archive & Reset (Optional): To save current results before wiping, copy /config/election-watcher/data/election_watcher.db on gateway, then click 🗑️ Reset Board in the top Admin bar.
  2. Add the Special Election Feed: Click + Add Custom Feed Source above and use the matching adapter:
    • AP / NYT (nyt_ap): https://static01.nyt.com/elections-assets/pages/data/YYYY-MM-DD/results-<state-slug>.json
    • PA Dept. of State (pa_dos_api): Update electionid=<ID> and electiontype=S in the electionreturns.pa.gov URL.
    • County / Clarity (lancaster_enhanced or clarity): Paste the county special election JSON endpoint.
  3. Verify & Save: Click Test Feed on the new row to confirm contests parse cleanly, then click 💾 Save and Apply Configuration.
  4. Go Live & Freeze When Done: Click ▶️ Activate Polling before polls close. Once certified, click ⏸️ Deactivate Polling to freeze the site in archive mode.
🗓️ Option B: Next General Election Season Rollover (2027 / 2028)
  1. Archive & Reset Database: Back up /config/election-watcher/data/election_watcher.db on gateway, then click 🗑️ Reset Board.
  2. Update Election Dates / Years in Feed URLs:
    • AP / NYT (nyt_ap): Replace 2026-11-03 with the new YYYY-MM-DD in config.yaml, parsers/nyt_ap.py (get_state_feed_url & derive_nyt_race_json_url), and templates.py. (For 2028, add results-president.json.)
    • NBC (nbc_firecracker): Replace 2026-elections with YYYY-elections (add /president-results for 2028).
    • CNN / NEP (cnn_nep): Replace 2026-SG.json, 2026-GG.json, 2026-HG.json with YYYY-SG/GG/HG.json (plus YYYY-PG.json for President).
  3. Refresh Open-Seat Defending Party Maps: Races with an incumbent on the ballot auto-detect flips via incumbent: true. Only retiring/open seats use OPEN_SENATE_DEFENDING_PARTY, OPEN_GOVERNOR_DEFENDING_PARTY, and OPEN_HOUSE_DEFENDING_PARTY in nyt_ap.py and nbc_cnn.py.
  4. Update Poll-Close Timer & Rebuild: Update getPollCloseCountdownText() in templates.py, run docker build -t election-watcher:latest . && docker compose up -d --force-recreate on gateway, and click ▶️ Activate Polling!
Daemon Uptime
0m
Continuous 24/7 loop
Total Poll Cycles
0
0 successful, 0 failed
Database Status
Connected
SQLite WAL mode
Usable Data Sources
0 / 0
Awaiting first live ballot drop
Last Poll Execution
Never
No errors logged

📡 Live Data Source Usability & Readiness Matrix

Distinguishes feeds that are 🟢 Pulling Usable Data (live 2026 ballots > 0) from feeds that are merely 🟡 Up - Schema Ready (0 Votes), 🟠 Up - Empty / Stale Year, or 🔴 Offline.
Source Data Usability Status Schema / Contests Parsed Contests Reporting Votes Total Ballots Pulled Last Checked
Loading source telemetry...

State Change History (The Audit Trail)

Timestamp Race ID Vote Delta Precincts Delta Reasons / Change Events
No deltas recorded yet.

📝 Elections Site Roadmap & To-Do List

Synced live with static file TODO.md. Check items off, add new tasks below, edit raw Markdown, or edit the file on disk.
0 / 0 Completed
Loading To-Do list...
Configuration saved successfully!