Skip to content
townhall.townNov 3, 2026

Privacy

townhall.town has no accounts and keeps as little as possible. This page lists exactly what the site stores and sends, and what we have not yet been able to promise.

The short version

We don't sell or share your information. There are no ads, no data brokers, and nothing goes to campaigns or parties. The site only needs your ZIP code. Your issue answers stay on your device.

No account

There is no sign-up, no login and no OAuth. townhall.town does not ask for your name, email, phone number or street address.

Your answers stay on your device

When you answer the issue questions, your answers are saved in your browser's localStorage under the key th-answers-v1 so they are still there next visit. They are not sent to the server. Clearing site data in your browser removes them.

The ballot agent and AI services

When you ask for a ballot, your browser sends only the 5-digit ZIP, in the body of a request to the site's /api/agent route. The server looks up the races for that ZIP. It then sends a short prompt containing the ZIP and our ballot data (not your answers) to an AI model that writes a summary. The model is reached through Vercel AI Gateway (today Google or OpenAI models). If a direct xAI key is configured, the prompt goes to xAI first. The server does not save the ZIP or the prompt.

Vercel says AI Gateway itself does not keep prompts or responses after a request completes. It keeps request metadata such as the model, provider, token counts, cost and timing. We have not turned on the gateway's zero-data-retention or no-training routing, so the AI provider's own data policy applies to the prompt.

Location

If you choose to use your location, your browser asks for permission first. The coordinates are sent in the body of a request to the site's /api/locate route, never in the web address. The server passes them to the public U.S. Census Geocoder to find the matching ZIP. townhall.town does not store the coordinates.

Analytics, cookies and server logs

townhall.town does not include analytics, ad pixels or tracking scripts, and it does not set cookies. The site is hosted on Vercel, which keeps standard request logs such as IP address, user agent and page path for operating the service, as described in Vercel's privacy policy. The site's own pages send your ZIP and coordinates in request bodies, not in the page path. We have not yet confirmed how many days Vercel keeps these logs for this project.

Other sites

Candidate photos are served from townhall.town itself, with credit to their source. Source links open other sites with their own policies.

The server also fetches public data while building a ballot. It sends candidate names or IDs to the FEC and Congress.gov, the county code for your ZIP to the Bureau of Labor Statistics, and market IDs for races to Polymarket. These requests come from our server, so they don't include your IP address, and they never include your answers.

If you use "Or tell Towny in your own words", what you type is sent to an AI model through Vercel AI Gateway only to fill in your answers, and is not saved. Towny research sends the candidate's name and office to a web search model and reads public pages. Please leave out names and addresses.

Messages

townhall.town does not run a texting, WhatsApp or email service yet, so it holds no phone numbers, email addresses or messages.

Contact

Questions about privacy: open an issue on GitHub. GitHub issues are public. We don't have a private contact address yet.