diff --git a/README.md b/README.md
new file mode 100644
index 0000000..fe33cdb
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+# ZMK configuration of the hands down layout
+
+Key characteristics:
+- [HD vibratium-vb|https://sites.google.com/alanreiser.com/handsdown/home/hands-down-neu#h.78qav8n932m7] using the [antecedent mod morph|https://github.com/zmkfirmware/zmk/pull/2042]
+- [Urob's timeless homerow mod|https://github.com/urob/zmk-config?tab=readme-ov-file#timeless-homerow-mods]
+- [Urob's ZMK helpers|https://github.com/urob/zmk-helpers] to simplify the code base
+-