diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..42e649a
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,21 @@
+# HTML Playground
+small template for having some stuff show up on a canvas.
+Canvas is dynamically sizing to the viewport.
+Space for debug info & buttons at the bottom
+
+
+
+## Structure
+
+Idea being that anything that is 'drawable' gets put into an array, and the render loop just puts those pixels on the canvas.
+
+
+
+
+
+# TODO
+- lerp between states 
+    - Should this be in the drawable's render routine?
+
+
+