diff --git a/.editorconfig b/.editorconfig
index dfce596..3aa9866 100644
--- a/.editorconfig
+++ b/.editorconfig
@@ -4,8 +4,10 @@ root = true
 end_of_file = lf
 insert_final_newline = true
 trim_trailing_whitespace = true
-
-[*.py]
 charset = utf-8
 indent_style = space
 indent_size = 4
+
+[*.md]
+indent_size = 2
+trim_trailing_whitespace = false
diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..3a08fb5
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,38 @@
+wedge: a puzzle game
+====================
+
+![screenshot](screenshot.jpg?raw=true)
+
+Mechanics:
+
+- **Objective:** Get the two players to reach the goals by navigating the level and pushing blocks around.
+- Blocks with triangular sections will push other blocks in the other direction.
+- Blocks of the same color will always move together.
+
+Controls: WASD for the left player and IJKL for the right player
+
+To-do list
+----------
+
+- [ ] Gameplay
+  - [x] Collision algorithm
+  - [x] Primitive animations
+  - [ ] Orientation indicator
+  - [ ] Unique textures
+- [ ] Cosmetics
+  - [ ] A real menu interface
+  - [ ] In-game editor
+
+Credits
+-------
+
+Original game made during MinneHack 2019: https://github.com/iptq/planar
+
+- Yeshi Cai
+- Mark Pekala
+- Alex Shi
+- Michael Zhang
+
+Rewrite: Michael Zhang
+
+License: MIT
diff --git a/screenshot.jpg b/screenshot.jpg
new file mode 100644
index 0000000..3c607dc
Binary files /dev/null and b/screenshot.jpg differ