diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4443f2c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,18 @@
+# endless mines
+
+A game in the vein of Minesweeper, but cleared rows disappear akin to Tetris. 
+Rows with exploded mines cannot be cleared. See how far you can get!
+
+Left-click to clear a tile. Right-click to flag a mine. Middle-click a number to clear any non-flagged adjacent tiles.
+
+## stuff to add
+move middle-click functionality to left-click instead
+add support for mobile devices/1-button mice (probably hold down to flag a mine)
+setup screen for difficulty/board size options
+scoring system (no. rows cleared/no. mines cleared, possibly timer)
+game over screen/restart button
+
+## bugs
+On clearing a row, blank tiles do not 'cascade' and reveal their adjacent tiles
+Game adds too many rows and they appear off the bottom of the screen
+middle-clicking causes middle-click-scroll to happen; this is probably related to above issue