Merge pull request #199 from CodeForPhilly/features/holo

Build site with hologit

.holo/branches/emergence-site/_emergence-github.toml

@@ -0,0 +1,4 @@
+[holomapping]
+files = "*/**"
+after = "skeleton-v2"
+before = "laddr"

.holo/branches/emergence-site/_emergence-redirects.toml

@@ -0,0 +1,4 @@
+[holomapping]
+files = "*/**"
+after = "skeleton-v2"
+before = "laddr"

.holo/branches/emergence-site/_emergence-saml2.toml

@@ -0,0 +1,4 @@
+[holomapping]
+files = "*/**"
+after = "skeleton-v2"
+before = "laddr"

.holo/branches/emergence-site/_emergence-slack.toml

@@ -0,0 +1,4 @@
+[holomapping]
+files = "*/**"
+after = "skeleton-v2"
+before = "laddr"

.holo/branches/emergence-site/_laddr.toml

@@ -0,0 +1,3 @@
+[holomapping]
+files = "*/**"
+after = "skeleton-v2"

.holo/branches/emergence-site/_skeleton-v2.toml

@@ -0,0 +1,2 @@
+[holomapping]
+files = "*/**"

.holo/branches/emergence-skeleton.toml

@@ -0,0 +1,4 @@
+[holobranch]
+# This skeleton holobranch is a variant of the site holobranch with lensing turned off
+extend = "emergence-site"
+lens = false

.holo/branches/example-codeforphilly/_codeforphilly.toml

@@ -0,0 +1,3 @@
+[holomapping]
+files = "*/**"
+after = [ "-skeleton" ]

.holo/branches/example-codeforphilly/_laddr.toml

@@ -0,0 +1,3 @@
+[holomapping]
+holosource = "-skeleton"
+files = "*/**"

.holo/config.toml

@@ -0,0 +1,2 @@
+[holospace]
+name = "laddr"

.holo/sources/-skeleton.toml

@@ -0,0 +1,2 @@
+[holosource.project]
+holobranch = "emergence-skeleton"

.holo/sources/codeforphilly.toml

@@ -0,0 +1,3 @@
+[holosource]
+url = "https://github.com/CodeForPhilly/codeforphilly.org"
+ref = "refs/heads/master"

.holo/sources/emergence-github.toml

@@ -0,0 +1,3 @@
+[holosource]
+url = "https://github.com/JarvusInnovations/emergence-github"
+ref = "refs/heads/master"

.holo/sources/emergence-redirects.toml

@@ -0,0 +1,3 @@
+[holosource]
+url = "https://github.com/JarvusInnovations/emergence-redirects"
+ref = "refs/heads/master"

.holo/sources/emergence-saml2.toml

@@ -0,0 +1,3 @@
+[holosource]
+url = "https://github.com/JarvusInnovations/emergence-saml2"
+ref = "refs/heads/master"

.holo/sources/emergence-slack.toml

@@ -0,0 +1,3 @@
+[holosource]
+url = "https://github.com/JarvusInnovations/emergence-slack"
+ref = "refs/heads/master"

.holo/sources/skeleton-v2.toml

@@ -0,0 +1,3 @@
+[holosource]
+url = "https://github.com/JarvusInnovations/emergence-skeleton-v2"
+ref = "refs/heads/emergence/skeleton"

.studiorc

@@ -0,0 +1,4 @@
+#!/bin/bash
+
+hab pkg install emergence/studio
+source "$(hab pkg path emergence/studio)/studio.sh"

README.md

@@ -10,13 +10,39 @@ There are three ways to get started with Laddr:
 - [Clone laddr](#clone-laddr) to work on and contribute to its core, shared functionality
 - [Extend laddr](#extend-laddr) to create a workspace for customizing a copy of laddr for your brigade without forking the whole thing
 
+### Dependencies
+
+Install recent versions of [Habitat](http://habitat.sh) and [Docker](https://www.docker.com/) on your Linux, Mac, or Windows workstation.
+
 ### Clone Laddr
 
-*TODO: document me*
+```bash
+cd ~/Repositories/laddr # or wherever you cloned this rep
+
+# expose port 7080 from any Docker container started by Habitat
+export HAB_DOCKER_OPTS="-p 7080:7080"
+
+# launch and enter a Habitat studio
+hab studio enter
+
+# once the studio has finished loading, start all services with a local database
+start-all-local
+
+# 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
 
-*TODO: document me*
+*TODO: Extending project docs*
+
+```bash
+# build the codeforphilly example extending project instead
+export EMERGENCE_HOLOBRANCH=example-codeforphilly
+watch-site
+```
 
 ## Support