diff --git a/README b/README
new file mode 100644
index 0000000..b421079
--- /dev/null
+++ b/README
@@ -0,0 +1,17 @@
+quadtree drawer
+
+HOW TO RUN
+
+clone the repo, then run a server from it. open the relevant address (e.g. localhost) in a javascript-executing web browser.
+
+CONTROLS
+
+left mouse button - draw
+right mouse button - zoom in
+
+z - zoom out
+x - zoom in
+
+space - zoom out
+
+click on buttons to change color and size.