diff --git a/image.jpg b/image.jpg
new file mode 100644
index 0000000..19cdae0
Binary files /dev/null and b/image.jpg differ
diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..73d31f4
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,7 @@
+# Hexingbird
+Hexingbird is a [hummingbird](https://github.com/PJE66/hummingbird) style split 30 key keyboard designed around [hexagonal keycaps](https://hw.s-ol.nu/HEX-keycaps/), which require Choc v1 switches.
+It uses the CH552T controller and [FAK firmware](https://github.com/semickolon/fak).
+![front view of keyboard](image.jpg)
+
+The PCB is reversible.
+The electronic design is inspired by the [MIAO MCU board](https://github.com/kilipan/miao) and adapted for split operation.