CodeForPhilly / laddr

http://codeforphilly.github.io/laddr/
MIT License
61 stars 35 forks source link

laddr

Laddr -- pronounced "ladder" and named after the essential tool for fire brigades -- is an online homebase for your local Code for America Brigade. It is designed to be cheap-to-host and easy-to-hack platform for civic hacking groups to maintain an online presence and automate support for their real-world operations.

Getting started

There are three ways to get started with Laddr:

Dependencies

Install recent versions of Habitat and Docker on your Linux, Mac, or Windows workstation.

Clone Laddr

cd ~/Repositories/laddr # or wherever you cloned this rep

# expose port 7080 (http) and 3306 (mysql) from any Docker container started by Habitat
export HAB_DOCKER_OPTS="-p 7080:7080 -p 3306:3306"

# launch and enter a Habitat studio
hab studio enter

# once the studio has finished loading, start all services with a local database
start-all

# clone a production instance's database
load-sql https://codeforphilly.org

# build and load the site, then wait for file changes
watch-site

At that point you should be able to see an instance at http://localhost:7080 and any edits should be reflected live

Extend Laddr

For a permanent instance of laddr, you might want to consider deploying an extending project rather than laddr itself. CodeForPhilly.org for example, is deployed from a repository that only contains a layer of customization that gets applied on top of laddr's repository. This gives you a place to change things like your brigade's logo or add new features without forking your own whole version of laddr.

To start a new extending project, initialize a new repository and copy the .holo/ tree from the codeforphilly repository as a starting point. Replace codeforphilly with an identifier of your choice for your own project (maybe the repository name) in .holo/config.toml and rename .holo/branches/emergence-site/_codeforphilly.toml to match.

Then follow the same steps above to launch the project inside a container.

Support

Features

Brigades using Laddr