diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..c777013d0ed2be567f4789c88526b049bf1e736e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,8 @@
+# Ethereum JavaScript API
+
+This is the Ethereum compatible JavaScript API implemented using
+`WebSocket` and `Promise`s.
+
+For an example see `index.html`.
+
+**Please note this repo is in it's early stage.**