README.md

Vote Tracker

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.
• 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 to initialize the database model.
4. Run vagrant ssh
5. On the Vagrant box, run cat /mnt/vagrant/fixture/*.sql | psql -U postgres votetracker to import the fixtures.
6. exit from the vagrant ssh.
7. Run npm start to start the file-watcher, api and live-reload process.
8. Browse to http://localhost:8080/ for the client.
9. Browse to http://localhost:8000/ or http://localhost:8080/api/ for the server.
10. Edit files in src/client to see things update automatically.
11. Edit files in src/server and the server will automatically restart.

Production Notes

In production, the server component is mounted at: http://votetracker.gnarf.net/api