diff --git a/example/htmx-templ/README.md b/example/htmx-templ/README.md
new file mode 100644
index 0000000..c247ffc
--- /dev/null
+++ b/example/htmx-templ/README.md
@@ -0,0 +1,15 @@
+# Htmx + Templ example
+
+This example demonstrates the use of translations in Templ templates.
+
+### run
+
+```sh
+go run .
+```
+
+### to rebuild templates
+
+```sh
+make generate
+```