diff --git a/angular.json b/angular.json
index b5c3b0265..3789ebeb2 100644
--- a/angular.json
+++ b/angular.json
@@ -11,7 +11,7 @@
                     "options": {
                         "aot": true,
                         "sourceMap": false,
-                        "outputPath": "dist",
+                        "outputPath": "dist/mosaic-io",
                         "index": "packages/docs/src/index.html",
                         "main": "packages/docs/src/main.ts",
                         "tsConfig": "packages/docs/tsconfig.json",
diff --git a/package.json b/package.json
index f7e3aba4e..e106f0eff 100644
--- a/package.json
+++ b/package.json
@@ -146,6 +146,7 @@
         "changelog": "gulp changelog",
         "ng": "ng",
         "docs:start": "ng serve",
+        "docs:prod-build": "ng build --aot --prod",
         "postinstall": "ngc -p angular.tsconfig.json",
         "preinstall": "node ./tools/npm/check-npm.js",
         "publish": "ts-node --project ./scripts/tsconfig.deploy.json ./scripts/deploy/publish-artifacts.ts",
diff --git a/packages/docs/README.md b/packages/docs/README.md
index 539ab99a5..043a4f8a3 100644
--- a/packages/docs/README.md
+++ b/packages/docs/README.md
@@ -1,6 +1,15 @@
 
-1. build:mosaic-examples
-2. build:mosaic
-3. build:docs
+## Development Setup
+1. build:mosaic-examples - generate dynamic examples (for Stackblitz)
+2. build:mosaic - generate our components for Docs App 
+3. build:docs - generate `docs-content` folder
 
-and run serve - docs:start
\ No newline at end of file
+
+## Development Server
+Start dev server documentation (aka ng serve)
+
+```bash
+yarn run docs:start 
+```
+
+open http://localhost:4200/
\ No newline at end of file
diff --git a/packages/docs/scripts/.gitkeep b/packages/docs/scripts/.gitkeep
new file mode 100644
index 000000000..e69de29bb
diff --git a/packages/docs/tools/.gitkeep b/packages/docs/tools/.gitkeep
new file mode 100644
index 000000000..e69de29bb