diff --git a/README.md b/README.md
index e69de29..2e11c80 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,20 @@
+# HD app
+HD app is the magic tool that allows the Happy Dev network to thrive in a decentralized way.
+
+## Install
+
+clone then:
+
+* `make install`
+
+## Build
+
+* `make build`
+
+or
+
+* `make watch`
+
+## Run server
+
+* `make serve`