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 current version is here https://WeVote.US and we are working on a new version now!

Installing WebApp

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

Installation on MacOs and Linux/WSL (Windows Subsystem for Linux)

1. Preparing the Environment on Your Machine (MacOS and Linux/WSL)
2. Bringing Code to Your Machine (MacOS and Linux/WSL)
3. Running WebApp for the First Time (MacOS and Linux/WSL)

Installation on Windows

1. Windows Simplified setup for the WebApp

<!-- Not up to date Automated Installation 1. [Run automated scripts](docs/installing/AUTOMATED_INSTALLATION.md) -->

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. Styling Guidelines

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

9. Working with ngrok to test on mobile

Thanks to BrowserStack for helping us with automated testing!

<a href="https://www.browserstack.com" target="_blank" rel="noopener noreferrer"><img src='src/img/global/logos/browserstack-logo-600x315.png' width='150' height='79'/></a>

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