diff --git a/README.md b/README.md
index e69de29bb2d1d6434b8b29ae775ad8c2e48c5391..2e11c80326ef1fde895f1e57b564d0e99601f052 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`