Code for America Brigades are local volunteer groups that bring together community members to help make government work better. Brigades use technology to build new tools to help with local civic issues. Code for America supports Brigade chapters with resources, tools, and access to the wider civic technology movement.
This repo is for the Brigade website https://www.codeforamerica.org/brigade
This website is meant to:
- Explain what the Brigade program is
- Help people find their local Brigade
- Show off the fine works of the Brigades
- Provide tools that help Brigade work
- Make it easy to start a new Brigade
The Brigade program started in 2012 as an experiment, largely copying the success of Open Gov Hack Night.
This website is on its third version. V1 Was a Rails site with many contributors. It served the Brigade well as it was growing. As Code for America became better at supporting the volunteer groups, we needed something different.
The CfAPI was built as reaction to how Brigades were operating themselves. We now meet them where they are, instead of trying to get them to log into our site.
V2 was powered by the CfAPI and worked great, yet was built quickly with PHP and Javascript. It was kind of a cobweb of dependent parts.
V3, the current site, is meant to simplify the code and make it easier for Brigade members to get involved in building the Brigade site.
The Project Search page is a new service we built to search across thousands of civic technology projects. Go try it out, we think its pretty useful.
Read more at README-Project-Search.md
Attendance is one of the basic metrics that needs to be tracked in movement building. Its useful for tracking the impact of your outreach, the growth of your group over time, and individual participation tracking. Its also incredibly useful for fundraising, considering many grants will accept volunteer hours as their matching funding requirement.
Read more at README-Attendance.md
The Code for America Brigade site is built on Flask and Python with a little bit of Javascript. The brigade/views.py file describes the routes. The brigade/templates files have the HTML templates.
Set up a Python virtual environment.
Install the required libraries.
To run locally, copy env.sample to .env and edit it to ensure that the environment variable BRIGADE_#_SECRET is present. Then run the server in debug mode:
python manage.py runserver
The server will be available at http://localhost:4000/brigade/.
or run it using Honcho and the Procfile:
honcho start
You can also run unit tests like this:
python manage.py runtests
Copyright (c) 2015 Code for America.