diff --git a/orx-shapes/README.md b/orx-shapes/README.md
index ad122ccb..46258315 100644
--- a/orx-shapes/README.md
+++ b/orx-shapes/README.md
@@ -2,3 +2,19 @@
 
 A collection of shape generators and modifiers
 
+<!-- __demos__ -->
+## Demos
+### DemoRegularPolygon
+[source code](src/demo/kotlin/DemoRegularPolygon.kt)
+
+![DemoRegularPolygonKt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/DemoRegularPolygonKt.png)
+
+### DemoRegularStar
+[source code](src/demo/kotlin/DemoRegularStar.kt)
+
+![DemoRegularStarKt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/DemoRegularStarKt.png)
+
+### DemoRoundedRectangle
+[source code](src/demo/kotlin/DemoRoundedRectangle.kt)
+
+![DemoRoundedRectangleKt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shapes/images/DemoRoundedRectangleKt.png)