diff --git a/README.md b/README.md
index e7f5a38d38984437922db301fdd59c40f532deaa..95a4b32f30b065aea62ef40b492635564acc4db1 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,15 @@
 # MetaVoxels Code
 
-Code for the design, simulation and optimization of MetaVoxels.
\ No newline at end of file
+Code for the design, simulation and optimization of MetaVoxels.
+
+## Documentation
+
+- Here: https://gitlab.cba.mit.edu/amiraa/metavoxels
+
+## Interactive Demos 
+
+- [Tendons Modeling](https://amiraa.pages.cba.mit.edu/metavoxels-code/demos/indexTendon.html)
+- [Precomputed 5*5 cuboct Voxel](https://amiraa.pages.cba.mit.edu/metavoxels-code/demos/indexScaling.html)
+- [Precomputed 4*1 chiral Voxel](https://amiraa.pages.cba.mit.edu/metavoxels-code/demos/indexChiral.html)
+- [Boundary Conditions](https://amiraa.pages.cba.mit.edu/metavoxels-code/demos/indexBoundaryConditions.htmll)
+- [Hierarchal multi-material 3*3 Base Voxel (old cpu version (to fix))](https://amiraa.pages.cba.mit.edu/metavoxels-code/demos/indexHierarchical.html)
\ No newline at end of file