Transparency & Methodology

Everything on this site comes from public government data or publicly available analysis. Here’s exactly what we use and how we use it.

Candidate information and fundraising comes from the Federal Election Commission (FEC) public filings API. Every candidate running for federal office files with the FEC, and those filings are public record. We sync this data regularly through admin tools.

Voting records are parsed from official XML feeds published by the U.S. Senate and House of Representatives — actual roll call votes on real legislation. We cross-reference these with GovTrack.us for additional context and verification.

Race ratings (Safe, Likely, Lean, Toss-up) come from the Cook Political Report and Sabato’s Crystal Ball — two nonpartisan analysts widely respected in political forecasting. We update ratings manually when analysts change their calls, typically checking monthly.

Primary election dates come from the National Conference of State Legislatures. State-specific election information links go directly to each state’s Secretary of State website — the official source for voter registration, polling locations, and ballot info.

The articles, guides, and deep dives on this site are written with AI assistance. But “AI-assisted” is not the same thing as “AI-generated,” and the distinction matters.

Here’s how it actually works: the human behind this project identifies the topic, does the initial research, chooses the angle, and asks questions to learn. AI helps draft, organize, and fact-check. The human reviews everything, rewrites what needs rewriting, and makes final editorial calls. Think of it like having a research partner who’s very fast at finding information — the voice, the judgment, and the editorial direction are human.

Every article on this site includes cited sources at the bottom. You can verify anything we’ve written by following those links to the original reporting, government documents, or research papers.

We link out to established organizations rather than trying to replicate what they already do well. These are the tools we trust and recommend throughout the site.

• Vote411 — Run by the League of Women Voters since 1920. Enter your address and see exactly what’s on your ballot.
• Vote.org — Check your registration, register to vote, find your polling place, and request an absentee ballot.
• GovTrack.us — Track legislation, explore voting records, and research any member of Congress. A model for how we try to work.
• Ballotpedia — The encyclopedia of American politics. Detailed pages for every race, candidate, and ballot measure.
• USA.gov — The federal government’s official guide to voting, registration deadlines, and ID requirements.

This is a one-person project built with AI development tools. The tech stack is Astro, React, Tailwind CSS, Supabase, and Vercel. One person couldn’t write all the content, do all the design, and build all the technology for a comprehensive voter education platform — not in this timeline. AI tools made it possible.

If you’re curious about how any of it works, reach out — we’re happy to talk about it.