diff --git a/examples/web-demo/README b/examples/web-demo/README
new file mode 100644
index 0000000..ef6b759
--- /dev/null
+++ b/examples/web-demo/README
@@ -0,0 +1,26 @@
+# SUAVE Web Demo
+
+## How to use
+
+Start the `suave-geth` development environment
+
+```
+$ cd examples/web-demo
+```
+
+```
+$ forge build
+```
+
+There should be a `out` directory generated, if not, you can run:
+
+```
+$ forge build --force
+```
+
+
+Then:
+
+```
+$ yarn & yarn dev
+```