diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..e38dd47
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,27 @@
+# Dreamcast Cake
+
+A rust demo I made for a friend's birthday.
+
+## Controls
+
+| button | action           |
+| -      | -                |
+| A      | remove one slice |
+
+## Building
+
+`just build`
+
+flash `cake.cdi` to a CD-R or run it in a dreamcast emulator.
+
+## Dependencies
+
+`just`
+
+[imagemagick](https://archlinux.org/packages/extra/x86_64/imagemagick/)
+
+[rust-kos](https://dreamcast.rs/setup.html)
+
+[cdi4dc](https://dreamcast.wiki/Cdi4dc)
+
+[makeip](https://github.com/Dreamcast-Projects/makeip)