Search by zip code!
Find out who represents you!
Look into a legislator's voting habits, campaign donations, and contact information.
Contact your congressperson about an issue that you care about!
Boosting politcal efficacy, one zip code at a time.
Available online now, try it out!
Currently, we feel that American citizens don't have easy access to the people who represent them in government. We made represent.us to forge a direct communication channel from representee to representative; from citizen to senator. Contacting a legislative official has never been easier, and we hope this tool will allow for more communication between elected officials and their constituents.
What it does
Step 1: Search your zip code.
Step 2: Choose a representative or senator.
Step 3: Learn about a person who represents you!
Step 4: (optional) Find something you want to talk about with your legislator? Fill out our contact form to send them a note.
Note: With the current setup, it will not actually send emails to congresspeople if you download and install yourself. The functionality is there, but one inadvertent test email to a Representative nipped that in the bud prematurely. :P
However, test emailing is live on our heroku app. Feel free to send notes via this app to see your messages get transferred to your own inbox instead of a legislator's.
- Clone our repository, and run
npm installin the main directory.
- To enable email sending, create an email account, put its password in a file named email.env
- Additionally, in the
transporterobject in the
/contacthandler, edit the
userfield to be your email address.
- Finally, change the
to:field within the
- Additionally, in the
How we built it
By integrating publicly available APIs from Sunlight, Wikipedia, and Govtrack with Node.js and Express.js functionality, we have created a simple tool that makes communicating with elected officials easier than ever before. Additionally, we present constituents with information about their representatives to help them make informed decisions in upcoming elections, as well as provide feedback regarding recent congressional votes.
Challenges we ran into
Wikipedia's API occasionally has hiccups with ambiguous search terms, so legislators with common names may not have the proper bio section displayed. Additionally, since half our team had never done web programming before, teaching new skills took a good chunk of our time.
Also, we accidentally sent a representative an email with less than intelligible contents while testing.
Accomplishments that we're proud of
Our two first-time hackers have a new understanding of a cutting edge technology. Additionally, we were able to fully integrate everything we had in mind at the start of our project! We ended up brainstorming a few more ambitious goals (Wikipedia bios, campaign finance info, etc.) that we were able to successfully implement.
What we learned
Creating a useful tool is easy with dedication, great friends, and an eagerness to learn.
What's next for represent.us
We're looking into also gathering information of state and local level legislators. Having easier access to all levels of government will further enable constituents to make knowledgeable decisions about the people they elect into power.
Who made this
represent.us was made during Bitcamp 2017 by four University of Maryland students: Alex Lees, Kevin Jordan, Sidhanth Tuli, and Steven Bower.