diff --git a/packages/react/examples/nano-repl/README.md b/packages/react/examples/nano-repl/README.md
new file mode 100644
index 00000000..5a8de496
--- /dev/null
+++ b/packages/react/examples/nano-repl/README.md
@@ -0,0 +1,15 @@
+# nano-repl
+
+this is an example of how to create a repl with strudel and react.
+
+## Usage
+
+after cloning the strudel repo:
+
+```sh
+pnpm i
+cd packages/react/examples/nano-repl
+pnpm dev
+```
+
+you should now have a repl running at `http://localhost:5173/`