diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..25e89df
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,13 @@
+
+# instructions
+
+action|key
+-|-
+draw black   | hold f or j
+draw white   | hold s or l
+resize brush | hold d or k, and move mouse
+
+# install
+```sh
+go install github.com/roodletoof/whiteboard@latest
+```