diff --git a/README.md b/README.md
index dcf6b31..d952ff5 100644
--- a/README.md
+++ b/README.md
@@ -1,21 +1,94 @@
-# vuex-feature-scoped-structure
+# vuex-feature-scoped-structure by igeligel
-> A Vue.js project
+> A Vue.js/Vuex project showcasing a complex but scalable store structure. This project was created in cooperation with [3yourmind](https://github.com/3YOURMIND).
-## Build Setup
+
+
+
+
-``` bash
-# install dependencies
-npm install
+## Showcase/Architecture
-# serve with hot reload at localhost:8080
-npm run dev
+A feature scoped, but still namespaced store structure. `index.vue` is the container of the module.
-# build for production with minification
-npm run build
+
+ diagram
+
+
-# build for production and view the bundle analyzer report
-npm run build --report
-```
+
+ file structure
+
+
-For a detailed explanation on how things work, check out the [guide](http://vuejs-templates.github.io/webpack/) and [docs for vue-loader](http://vuejs.github.io/vue-loader).
+## Dependencies
+
+
+
+## Installation
+
+The installation process is split into two sections for [development](#development) and [production](#production) use. You can find a production version of this site live at [vuex-simple-structure.netlify.com](https://vuex-simple-structure.netlify.com/).
+
+### Development
+
+
+ instructions
+
+ #### Using npm
+
+ ```shell
+ npm install
+ npm run dev
+ ```
+
+ #### Using yarn
+
+ ```shell
+ yarn install
+ yarn run dev
+ ```
+
+
+### Production
+
+
+ instructions
+
+ #### Using npm
+
+ ```shell
+ npm install
+ npm run build
+ ```
+
+ #### Using yarn
+
+ ```shell
+ yarn install
+ yarn run build
+ ```
+