diff --git a/README.md b/README.md
new file mode 100644
index 0000000..87dfab0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,14 @@
+# JS Canvas Playground
+
+Various experiments in javascript canvas
+
+## Run locally
+
+```bash
+// Compile typescript files
+$ tsc -w
+// Serve the content of current directory
+$ python3 -m http.server
+$ firefox localhost:8000
+```
+