Quadratic Voting (live)

Open-source, real-time QV dashboard.

Quadratic Voting is the mathematically optimal way to vote in a democratic community, where votes express the degree of your preferences, not just direction. This calculator is an open-source voting application, with development supported by Gitcoin, and is a counterpart to the Quadratic Funding Calculator.

Architecture

This application is built atop

1. Front-end: NextJS (React)
2. Back-end: NodeJS + Express serverless functions deployed on Vercel
3. Database: PostgreSQL + the Prisma DB toolkit

At a fundamental level, the way in which voting links are generated and sessions are handled is kept simple:

1. An events table keeps track of open voting events. Each event has a secret_key (uuid) to manage the event.
2. A voters table keeps track of all voters and their preferences. Each voter has a id (uuid) that together with the event_uuid (uuid) represents their unique voting URL.

Important files:

1. prisma/schema.sql contains the SQL schema for the application.
2. pages/api/events/details.js contains the QV calculation logic.

Run locally / redeploy

1. Setup your PostgreSQL database

# Import schema
pg:psql -f prisma/schema.sql

2. Setup environment variables. Copy prisma/.env.sample to prisma/.env and replace DATABASE_URL with your PostgreSQL DB url.

3. Run application

# Install dependencies
yarn

# Run application
yarn dev

License

GNU Affero General Public License v3.0