A Rails and Angular app for keeping up with your elected reps' activity in Congress.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
app
bin
config
db
lib
log
public
test
tmp
vendor/assets
.gitignore
Gemfile
Gemfile.lock
LICENSE.md
README.md
Rakefile
config.ru
notes.md
spec.md

README.md

LegisLately

LegisLately is a webapp that makes it easier to follow activity in Congress. Unregistered users can search using their address to pull up the names and recent activity of their reps - when logged in, users get the ability to follow particular legislators and get all recent votes in a Twitter-style newsfeed.

Getting Started

  1. Fork and clone the repository to your local machine.

  2. Run bundle install to install dependencies.

  3. You'll need two API keys, both set as environment variables:

    a. the ProPublica Congress API

    b. the Google Civic Information API

Dotenv is already set up for the app, so all you need to do is create an empty .env file in the root folder and add the following lines:

export GOOGLE_API_KEY=yourgoogleapikey
export PROPUBLICA_API_KEY=yourpropublicaapikey
  1. Run rails s to start the server.

  2. Navigate to localhost:3000 in your browser.

Prerequisites

You'll need Ruby and RubyGems installed - I like RVM for this purpose.

\curl -sSL https://get.rvm.io | bash -s stable
rvm install 2.3.1

You'll also need PostgreSQL installed locally. Installation varies among systems, but you can find detailed install instructions here.

Running the tests

Run rspec to run the test suite.

Built With

  • Rails 5 - Everyone's favorite Ruby back end web framework
  • AngularJS 1.5 - Front end Javascript framework for dynamic web apps
  • Bootstrap 3 - CSS framework for developing good-looking, mobile-friendly websites
  • Devise - A flexible authentication engine for Rails apps

Contributing

Bug reports and pull requests are welcome at https://github.com/radditude/legislately. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Convenant code of conduct.

Authors

CJ Horton - radditude

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Acknowledgments

  • Big thanks to the folks at ProPublica for answering my questions while they were in the middle of taking over the Sunlight Labs Congress API
  • Equally big thanks to the folks of the now-former Sunlight Labs for their excellent Congress API, which originally gave me the idea for this app
  • Jesse Novotny's excellent Rails/Angular/Devise tutorial was a big help with getting the Angular/Devise interactions to function properly.