diff --git a/README.md b/README.md
new file mode 100644
index 0000000..60edaf0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,19 @@
+# Whiskey Pirates DC22
+
+This should be all that is necessary to build a binary for the WP DC22 badge.
+
+### Building Firmware
+todo: include details on how to build
+but in short:
+- open with platformio and just build it
+- use stlink to program stm32l100
+- use whatever to program attiny88
+
+### Loading the Firmware Binary
+there isn't a binary yet
+
+### Todo
+see TODO.md (to be created)
+
+### User Guide
+tbd
\ No newline at end of file