A Ruby on Rails Application that generates a National Voter Registration Form PDF from a webform. Includes the guidelines for the National Voter Registration form in all states.
Ruby CoffeeScript JavaScript
Latest commit e0e58d6 Apr 30, 2013 @ryanatwork ryanatwork Merge pull request #32 from dennym/patch-1
fix erförderlich to erforderlich
Permalink
Failed to load latest commit information.
app
config fix erförderlich to erforderlich Apr 30, 2013
data Remove state-specific info now that it's likely out-of-date Jan 25, 2013
db
doc Fixes names and links in documentation Sep 4, 2012
lib
log
public
script
spec
vendor
.gitignore
.rbenv-version
.rspec
.travis.yml
ADVISORY
CONTRIBUTING.mkd Adds contributing file [ci skip] Sep 17, 2012
Gemfile Update Rails to 3.2.12 Mar 28, 2013
Gemfile.lock Update Rails to 3.2.12 Mar 28, 2013
LICENSE
README.md
Rakefile
TODO.mkd Add prawn fill form fix to TODO [ci skip] Sep 18, 2012
config.ru Initial commit. Go, democracy! Aug 31, 2012

README.md

Voter Registration Build Status

Code Climate

About

We need more Americans to have a say in their government, not just the special interests. That's why we should be taking down roadblocks to voting. We believe in an America where everybody can make their voices heard.

That is why the Democratic National Committee created this open source application to provide more opportunities to register to vote in November! States have varying laws for voter registration, so this application is a one stop shop that contains all the voter registration information and voting checklists that you will need to vote. This information should not be altered.

You can help all eligible voters register to vote by using this software.

What is it?

A Ruby on Rails Application that generates a National Voter Registration Form PDF from a webform. Includes the guidelines for the National Voter Registration form in all states.

Demo

You can see a running version of the application at http://voter-registration.herokuapp.com/

Requirements

  1. Make sure the machine that you're using has Ruby 1.9.3 installed. We use rbenv for Ruby version management
  2. You'll need the RubyGem "bundler" installed.

Installation

git clone git@github.com:democrats/voter-registration.git
cd voter-registration
bundle install
rake db:migrate
rake db:seed #This will load all the State information

Usage

rails server

Open up your browser and go to http://localhost:3000

Deploying to Heroku

You can setup a Heroku account for free https://devcenter.heroku.com/articles/quickstart

heroku create
heroku addons:add sendgrid:starter  # Free addon used for devise emails
heroku config:set SECRET_TOKEN=$(bundle exec rake secret)  # generate a unique secret token
git push heroku master
heroku run rake db:migrate
heroku run rake db:seed

Running Tests

We use RSpec for tests: bundle exec rake spec

Admin the pages

We use rails_admin to manage the State Guidelines Go to "/admin" to login and manage the Guidelines

The default email: admin@example.com The default password: p@ssw0rd

Supported Ruby Versions

This application aims to support and is tested against the following Ruby implementations:

  • Ruby 1.9.3

Contributing

Check out contributing for ways that you can contribute

Documentation

Documentation is available in the /doc directory in the root of the project.

License

Voter Registration is open source software; please see LICENSE in this directory for licensing information.