diff --git a/readme.md b/readme.md
index e69de29..c94e080 100644
--- a/readme.md
+++ b/readme.md
@@ -0,0 +1,3 @@
+Example of building a portal like micro-frontends for multiple react SPA's. Each react project is totally self contained and should be deployed separately.
+
+## Root project configuration