diff --git a/README.md b/README.md
new file mode 100644
index 0000000..a71a42c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,24 @@
+Embark-Haml
+======
+
+Plugin for [Embark](https://github.com/embark-framework/embark) to support haml templates
+
+Installation
+======
+
+In your embark dapp directory:
+```npm install embark-haml --save```
+
+then add embark-solc to the plugins section in ```embark.json```:
+
+```Json
+  "plugins": {
+    "embark-haml": {}
+  }
+```
+
+Requirements
+======
+
+- Embark 3.0.0 or higher
+