diff --git a/README.md b/README.md
new file mode 100644
index 0000000..eb9c022
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+# Hello htmx
+
+This is a demo project to try out [htmx] with rust alongside the [HYPERMEDIA
+SYSTEMS] book.
+
+[htmx]: <https://htmx.org/>
+[HYPERMEDIA SYSTEMS]: <https://hypermedia.systems/book/contents/>