diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e0bcdbc
--- /dev/null
+++ b/README.md
@@ -0,0 +1,18 @@
+# button
+
+This repository contains code for solving the challenges from [button.qedaka.de](button.qedaka.de). There are eight
+challenges in total:
+- [01_welcome](./js/01_welcome.js)
+- [02_these_numbers_are_big](./js/02_these_numbers_are_big.js)
+- [03_are_you_still_doing_this_by_hand](./js/03_are_you_still_doing_this_by_hand.js)
+- [04_broken_proof_of_work](./js/04_broken_proof_of_work.js)
+- [05_what_the_bf](./js/05_what_the_bf.js)
+- [06_automation_is_not_enough](./js/06_automation_is_not_enough.js)
+- [07_weird_assembly_machine](./js/07_weird_assembly_machine.js)
+- [08_revisit_everything](./js/08_revisit_everything.js)
+
+Challenges one through four are trivial to solve. For challenges five through eight there is one binary each which
+demonstrates an approach to a solution.
+
+One additional binary for solving the whole puzzle from start to finish is provided.
+