diff --git a/v3/README.md b/v3/README.md
index 1c1f25fde..4e78bee3d 100644
--- a/v3/README.md
+++ b/v3/README.md
@@ -1,3 +1,28 @@
 # v3
 
-This directory is experimental. It probably won't work for you. There's no support for this directory. Dragons be here. You have been warned!
\ No newline at end of file
+This directory is experimental. It probably won't work for you. There's no support for this directory. Dragons be here. You have been warned!
+
+## Run examples
+follow these steps to run the examples:
+-  clone the repo
+```cmd
+git clone https://github.com/wailsapp/wails.git
+```
+-  switch to v3-alpha branch
+```cmd
+git checkout v3-alpha
+```
+-  install dependencies 
+  ```cmd 
+go mod tidy
+```
+-  run the example you want
+```cmd
+cd v3/examples/(example you want)
+```
+```cmd
+go mod tidy
+```
+```cmd
+go run main.go
+```