diff --git a/README.md b/README.md
new file mode 100644
index 00000000..f832cffc
--- /dev/null
+++ b/README.md
@@ -0,0 +1,25 @@
+# gancio
+an event manager for radical communities
+[WIP]
+ 
+# dev
+both backend (`/app`) and frontend(`/client) are in this repo.
+
+backend stack: node.js, express, sequelize.  
+frontend stack: vue, webpack, boostrap
+
+```
+git clone https://github.com/lesion/gancio.git
+cd gancio 
+# install back-end dependencies
+yarn
+# run back-end in development mode
+yarn dev
+
+cd client
+# install front-end dependencies
+yarn
+# run front-end in development mode
+yarn dev
+```
+