diff --git a/blink/readme.md b/blink/readme.md
new file mode 100644
index 0000000..0032f4b
--- /dev/null
+++ b/blink/readme.md
@@ -0,0 +1,42 @@
+
+# Blink
+
+This 'Hello World' equivalent simply blinks the RGB LED. They're high intensity LEDs that will almost
+burn your eyeballs if you stare at it long enough.
+
+# Requirements
+
+* Yosys
+* Arachne-pnr
+* Project IceStorm
+
+# Usage
+
+* ```make```
+
+    Builds ```chip.bin``` bitstream
+
+* ```make flash```
+
+    Program the bitstream to the device.
+
+Expected output during flashing:
+
+```
+ubuntu@ubuntu-xenial:~/projects/upduino$ sudo make flash
+iceprog chip.bin
+init..
+cdone: high
+reset..
+cdone: high
+flash ID: 0xEF 0x40 0x16 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00
+file size: 104090
+erase 64kB sector at 0x000000..
+erase 64kB sector at 0x010000..
+programming..
+reading..
+VERIFY OK
+cdone: high
+Bye.
+```
+