1 files changed, 62 insertions, 0 deletions
diff --git a/web/README.md b/web/README.md
new file mode 100644
index 0000000..d470960
--- /dev/null
+++ b/web/README.md
@@ -0,0 +1,62 @@
+# The web component
+
+## How to run in your LOCAL env:
+
+### Requirements
+
+1. docker (or local mongodb install)
+2. npm
+
+#### Steps
+
+1. Spawn up a docker container with mongodb OR start mongo from local install
+
+  `docker run -d --name mymongo -p 27017:27017 mongo`
+
+2. enter inside the container:
+
+  `docker exec -it mymongo mongo`
+
+3. run inside the interactive mongo shell:
+
+  `use helpthehome`
+
+4. Put in some dummy data to start, run:
+
+```
+db.pointscollection.insert({
+	"type": "MultiPoint",
+	"name": "points",
+	"color": "#0000ff",
+	"style": {
+		"radius": 8,
+		"fillColor": "#00ce00",
+		"color": "#008c00",
+		"weight": 2,
+		"opacity": 1,
+		"fillOpacity": 1
+	},
+	"coordinates": [-73.9580, 40.8003]
+})
+```
+
+5. Now you are ready to start the app:
+
+  From this directory:
+
+  `npm install`
+
+  `npm start`
+
+  Then open your browser to `localhost:3000`
+
+You should be greeted with a page with a map. From next time onwards, just start up the mongo container with `docker start mymongo`.
+
+## You can view the current latest production site on Heroku (master branch)
+
+not yet.
+
+## You can view the current latest QA site on Heroku (qa branch)
+
+https://helpthehome-qa.herokuapp.com/
+