WeVote 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 apply for a volunteer position through that page.

Our live site, running the current version of our software is here https://WeVote.US and are constantly improving it!

Installing WebApp

Our installation process is built to allow engineers all over America to contribute to WeVote.

It allows anyone to be in a position to make suggestions, and get involved.

See our installation instructions leveraging Docker and the (free) WebStorm IDE:

Installing with WebStorm and Docker

These instructions also can be used with Linux, both with and without WebStorm, and with Windows/WSL.

Working with WebApp

1. Working with WebApp Day-to-Day

2. What the Heck is a Pull Request?

3. Before Your First Pull Request

4. Creating a Pull Request

5. Debugging Tools and Tips

6. Issues and Reporting Bugs

7. 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!!