diff --git a/.demos/simple-brightscript/.env b/.demos/simple-brightscript/.env
deleted file mode 100644
index 360f682..0000000
--- a/.demos/simple-brightscript/.env
+++ /dev/null
@@ -1,2 +0,0 @@
-#ROKU_PWD={YOUR_ROKU_DEVICE_DEV_PASSWORD}
-#ROKU_HOST={YOUR_ROKU_DEVICE_IP_ADDRESS}
\ No newline at end of file
diff --git a/.demos/simple-brightscript/.gitignore b/.demos/simple-brightscript/.gitignore
deleted file mode 100644
index d52e996..0000000
--- a/.demos/simple-brightscript/.gitignore
+++ /dev/null
@@ -1,6 +0,0 @@
-#Visual Studio Code
-.vscode
-out/
-
-#npm
-/node_modules
\ No newline at end of file
diff --git a/README.md b/README.md
index c3aa0af..981a5aa 100644
--- a/README.md
+++ b/README.md
@@ -33,6 +33,9 @@ npx ropm install promises@npm:@rokucommunity/promises
     └─ manifest
     ```
 
+## Demos
+You can check out a few demos in the [demos/](./demos) folder to see some good examples of how to use this library in practice.
+
 ## Anatomy of the `Promise` node
 The heart of this library is the `Promise` SGNode type. Here's its contents:
 
diff --git a/.demos/simple-brightscript/components/MainScene.brs b/demos/simple-brightscript/components/MainScene.brs
similarity index 100%
rename from .demos/simple-brightscript/components/MainScene.brs
rename to demos/simple-brightscript/components/MainScene.brs
diff --git a/.demos/simple-brightscript/components/MainScene.xml b/demos/simple-brightscript/components/MainScene.xml
similarity index 100%
rename from .demos/simple-brightscript/components/MainScene.xml
rename to demos/simple-brightscript/components/MainScene.xml
diff --git a/.demos/simple-brightscript/components/NetworkTask.brs b/demos/simple-brightscript/components/NetworkTask.brs
similarity index 100%
rename from .demos/simple-brightscript/components/NetworkTask.brs
rename to demos/simple-brightscript/components/NetworkTask.brs
diff --git a/.demos/simple-brightscript/components/NetworkTask.xml b/demos/simple-brightscript/components/NetworkTask.xml
similarity index 100%
rename from .demos/simple-brightscript/components/NetworkTask.xml
rename to demos/simple-brightscript/components/NetworkTask.xml
diff --git a/.demos/simple-brightscript/components/Promise.xml b/demos/simple-brightscript/components/Promise.xml
similarity index 100%
rename from .demos/simple-brightscript/components/Promise.xml
rename to demos/simple-brightscript/components/Promise.xml
diff --git a/.demos/simple-brightscript/images/channel-poster_fhd.png b/demos/simple-brightscript/images/channel-poster_fhd.png
similarity index 100%
rename from .demos/simple-brightscript/images/channel-poster_fhd.png
rename to demos/simple-brightscript/images/channel-poster_fhd.png
diff --git a/.demos/simple-brightscript/images/channel-poster_hd.png b/demos/simple-brightscript/images/channel-poster_hd.png
similarity index 100%
rename from .demos/simple-brightscript/images/channel-poster_hd.png
rename to demos/simple-brightscript/images/channel-poster_hd.png
diff --git a/.demos/simple-brightscript/images/channel-poster_sd.png b/demos/simple-brightscript/images/channel-poster_sd.png
similarity index 100%
rename from .demos/simple-brightscript/images/channel-poster_sd.png
rename to demos/simple-brightscript/images/channel-poster_sd.png
diff --git a/.demos/simple-brightscript/images/splash-screen_fhd.png b/demos/simple-brightscript/images/splash-screen_fhd.png
similarity index 100%
rename from .demos/simple-brightscript/images/splash-screen_fhd.png
rename to demos/simple-brightscript/images/splash-screen_fhd.png
diff --git a/.demos/simple-brightscript/images/splash-screen_hd.png b/demos/simple-brightscript/images/splash-screen_hd.png
similarity index 100%
rename from .demos/simple-brightscript/images/splash-screen_hd.png
rename to demos/simple-brightscript/images/splash-screen_hd.png
diff --git a/.demos/simple-brightscript/images/splash-screen_sd.png b/demos/simple-brightscript/images/splash-screen_sd.png
similarity index 100%
rename from .demos/simple-brightscript/images/splash-screen_sd.png
rename to demos/simple-brightscript/images/splash-screen_sd.png
diff --git a/.demos/simple-brightscript/manifest b/demos/simple-brightscript/manifest
similarity index 100%
rename from .demos/simple-brightscript/manifest
rename to demos/simple-brightscript/manifest
diff --git a/.demos/simple-brightscript/source/main.brs b/demos/simple-brightscript/source/main.brs
similarity index 100%
rename from .demos/simple-brightscript/source/main.brs
rename to demos/simple-brightscript/source/main.brs
diff --git a/.demos/simple-brightscript/source/promises.brs b/demos/simple-brightscript/source/promises.brs
similarity index 100%
rename from .demos/simple-brightscript/source/promises.brs
rename to demos/simple-brightscript/source/promises.brs