README.md

VoteTracker

Dependencies

The following will need to be installed on your local development machine before you can use this workflow. All versions should be the latest available, as some required features may not be available in older versions.

Required for Development

• node.js 4.3.x
  • Download (All platforms)
  • Install node via homebrew
• Ansible 2.x
  • Install ansible via apt (Ubuntu), yum (Fedora), homebrew (OS X), etc. See the Ansible installation instructions for detailed, platform-specific information. If you don't end up with version 2, try easy_install pip and pip install ansible.
• VirtualBox
  • Download (All platforms)
  • Install virtualbox via homebrew cask (OS X)
• Vagrant
  • Download (All platforms)
  • Install vagrant via homebrew cask (OS X)
• vagrant-hostsupdater
  • Install with vagrant plugin install vagrant-hostsupdater (All platforms)

Development

1. Run npm install to install local dependencies.
2. Run vagrant up to set up postgresql database.
3. Run npm run migrate:up to initialize the database model.
4. Run vagrant ssh -- cat /mnt/vagrant/fixtures/*.sql \| psql -U postgres votetracker to import the fixtures.
5. Run npm start to start the file-watcher, api and live-reload process.
6. Browse to http://localhost:8080/ for the client.
7. Browse to http://localhost:8000/ or http://localhost:8080/api/ for the server.
8. Edit files in src/client to see things update automatically.
9. Edit files in src/server and the server will automatically restart.

Production Notes

In production, the server component is mounted at: http://votetracker.berniesanders.com/api

Troubleshooting Local Environment

Vagrant port forwarding issue "The forwarded port to 5432 is already in use on the host machine."

If you see this error, it's possible you've already got postgres (the database) already running on your machine. If you're on a 'nix system, try entering sudo service --status-all at the command line. If you see something that looks like this [ + ] postgresql in the output, stop the service by entering sudo service postgresql stop and attempt to bring up vagrant again.