README.md

We Vote WebApp

This WebApp repository contains a Node/React/Flux Javascript application. Using data from Google Civic API, Vote Smart, MapLight, TheUnitedStates.io and the Voting Information Project, we give voters a social way to interact with ballot data.

Interested in volunteering or applying for an internship? Starting presentation here. Please also read about our values and see our Code of Conduct To join us, please review our openings here, and express your interest by emailing [email protected]

Our current Beta version is here https://WeVote.US and we are working on version 2 now!

Installing WebApp

Our installation process is built to allow engineers all over America to contribute to We Vote. It may seem complicated, but it allows anyone to be in a position to make suggestions, and get involved.

Manual Installation

1. Preparing the Environment on Your Machine

2. Bringing Code to Your Machine

3. Running WebApp for the First Time

Automated Installation

1. Run automated scripts

Working with WebApp

1. Working with WebApp Day-to-Day

2. Debugging Tools and Tips

3. Issues and Reporting Bugs

4. Styling Guidelines

5. Want to sign in with Facebook or Twitter on localhost?

6. Working with ngrok to test on mobile

Thanks to BrowserStack for helping us with automated testing!

Contributing to the Project

Please read the following before you start contributing to the project. Thank you!

Coding Standards and Best Practices

How to Submit Code / Pull Requests

1. What the Heck is a Pull Request?

2. Before Your First Pull Request

3. Creating a Pull Request

4. Pull Request Advanced Tips & Tricks

5. Troubleshooting Pull Request Problems

6. Approving Pull Requests

7. Progressive Web App Feature

Testing WebApp

1. Introduction to WebApp testing

2. Explanation of various files

Welcome aboard!!