diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d34497c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,5 @@
+# blackout.tilde.town
+
+this is the code for [blackout.tilde.town](https://blackout.tilde.town).
+
+the database that powers this was made using [gutchunk](https://git.tilde.town/~vilmibm/gutchunk).