/simple-vote

SimpleVote - An open-source, live updating, voting platform based on range voting.

Primary LanguageTypeScriptGNU General Public License v3.0GPL-3.0

SimpleVote — An open-source, live updating, voting platform.

Build Status

SimpleVote is an open-source, self-hostable, live-updating voting/polling platform, for both live meetings, or extended polls.

Polls can be dynamic, meaning users can(if allowed) contribute options and questions themselves.

It uses range voting (also known as olympic score voting) for all your poll options. Range voting is more expressive than simple 👍 or 👎 votes (IE approval). It also beats out IRV, and first past the post for minimizing voter regret.

Features:

  • Polls can have multiple questions.
  • Anyone can edit, delete, or create additional questions, and options (if allowed by the creator), at anytime.
  • Live chat on the sidebar.
  • Questions can have expiration times, and thresholds (Making sure options with too few votes don't win).
  • Easily shareable poll links.
  • Image and markdown support for all questions and candidates.
  • Questions can hide voter names (anonymous voting).
  • Questions can be either Range, or Pointing Poker style.

Tech used:

Check out a sample poll here.

Change log

Screenshots

image


Installation

If you want to self-host or help develop simplevote.

Docker

Requirements

  • Docker
  • docker-compose

Start the docker instance

git clone https://github.com/dessalines/simple-vote
cd simple-vote
// edit ARG ENDPOINT_NAME=http://localhost:4567 in ./Dockerfile to your hostname
docker-compose up

Goto to http://localhost:4567

Local development

Requirements

  • Java 8 + Maven
  • Node + npm/yarn, nvm is the preferred installation method.
  • angular-cli: npm i -g @angular/cli@latest
  • Postgres 9.3 or higher

Download SimpleVote

git clone https://github.com/dessalines/simple-vote

Setup a postgres database

Here are some instructions to get your DB up and running.

psql -c "create user simplevote with password 'asdf' superuser"
psql -c 'create database simplevote with owner simplevote;'

Open your pom.xml

cd simplevote
vim service/pom.xml

Edit it to point to your own database:

<!--The Database location and login, here's a sample-->
<jdbc.url>jdbc:postgresql://127.0.0.1/simplevote</jdbc.url>
<jdbc.username>simplevote</jdbc.username>
<jdbc.password>asdf</jdbc.password

Install SimpleVote

For local testing:

./install_dev.sh and goto http://localhost:4567/

For a production environment, edit ui/src/environments/environment.prod.ts to point to your hostname, then run:

./install_prod.sh

You can redirect ports in linux to route from port 80 to this port:

sudo iptables -t nat -I PREROUTING -p tcp --dport 80 -j REDIRECT --to-ports 4567


Bugs and feature requests

Have a bug or a feature request? If your issue isn't already listed, then open a new issue here.

TODO

  • Set up travis-ci