Skip to content

Code4Maine/beehve

Repository files navigation

Stories in Ready Beehve

Build Status

Inspired and heavily copied from laddr, Beehve aims to be a one-stop-shop for what's going in our Code for America Bridage in Maine: Code 4 Maine. Mostly, as a Django dev in my other life, I couldn't stomach hacking on the PHP codebase of laddr. So hopefully we can get this app to a place where it will meet our needs and be highly extensible as well.

Of course there are always trade-offs, and, as a Django app, deployment is not what it could be. But hopefully I can get it hooked up with Herkou and make it pretty easy to get started.

Features include:

  • Project tracking
  • Members directory
  • Github integration
  • Project buzz
  • Big screen for public events

Not all of these work yet, but we're on way to a 1.0.

Deployment

Deployment of Beehve is done via the ansible roles found in the ansible directory (tada ...). Usage of these roles is contingent on a few configuration details:

  1. Configure your target hosts in the ansible/hosts file
  2. Copy ansible/hosts_vars/www.example.com ansible/host_vars/www.yourdomain.com
  3. Fill in the details of the host_vars file
  4. Run: ansible-playbook -i ansible/hosts --limit production ansible/all.yml

Easy bootstrapping!

Powered by the ubiquitous Makefile ... this should be pretty easy:

  1. make install
  2. make run
  3. open your browser to: http://127.0.0.1:45000

Alternately, you can build a vagrant box, in case you're not on Linux:

  1. vagrant up

That's pretty slick, but will also come with some "issues"

Librarys, librarys, librarys!

Of course, we could provide a vagrant file and a provisoner and all that jazz. But I'd rather provide a make file for installing everything into a venv and let you muck about with libraries. Those of you on Linux shouldn't have too much trouble installing the requisite development libraries below. The names are for debian-based distros, but they exist for all major distros.

On Mac it may be a little tricker. Homebrew will get you quite far, but first you have to install the bloated XCode and the CLI tools.

The libraries are:

  • libmemcached-dev
  • libfreetype6-dev
  • libjpeg-dev