diff --git a/README.md b/README.md
index e69de29..65c2f0d 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,9 @@
+# This thing
+
+This is me playing around with my new Icebreaker FPGA with nmigen(_dg).
+The goal is to find a nice project structure and perhaps find a way to work on my Arty a7 with a FOSS toolchain.
+
+# try it:
+
+	poetry run python -m fpga.icebreaker
+	poetry run python -m fpga.modules.blinker generate