A plain-text file format for voting guides. One .oval file is one guide: the election, the ballot
as the voter sees it, each contest and measure, and the author's recommendation with the reasoning
behind it.
oval 1
guide "Franklin Voter Guide"
election "November 3, 2026 General Election"
date 2026-11-03
party @dem "Democratic"
ballot @franklin "State of Franklin"
section "Statewide Offices"
contest @gov "Governor" single
campaign incumbent @jlee "Jordan Lee"
party @dem
campaign @rkim "Riley Kim"
recommend
support @jlee
justification:
Lee delivered on the transit plan.
measure @prop1 "Proposition 1"
supporters "Franklin Transit Alliance"
opponents none
recommend yes
- Specification, developed in oval-spec.
- Reference implementation in Rust, with the
ovalcommand line tool and@oval-vote/ovalfor JavaScript. - Visual Studio Code extension, developed in vscode-oval.
The language is at major version 1. The specification is a working draft ahead of its 1.0.0 release, and each tool is versioned on its own.