diff --git a/README.md b/README.md
index 3b10895..0d1fc1c 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,18 @@
-# ant-colony-simulation
-Ant colony simulation with TypeScript and p5.js
+# Ant Colony Simulation
+
+[Live Demo](https://hasnainroopawalla.github.io/ant-colony-simulation/)
+
+A simulator for the ant colony optimization algorithm in p5.js using TypeScript and React ([inspiration](https://youtu.be/X-iSQQgOd1A?si=XYnjKHSCwMdGiX5T)).
+
+<p align="center">
+<img src="assets/simulation.gif" alt="simuation" width="500"/>
+</p>
+
+A Python implementation of this optimization algorithm to find the shortest path in a graph can be found at [github.com/hasnainroopawalla/Ant-Colony-Optimization](https://github.com/hasnainroopawalla/Ant-Colony-Optimization).
+
+## Contributing
+- Post any issues and suggestions on the GitHub [issues](https://github.com/hasnainroopawalla/ant-colony-simulation/issues) page.
+- To contribute, fork the project and then create a pull request back to master.
+
+## License
+This project is licensed under the MIT License - see the [LICENSE](https://github.com/hasnainroopawalla/ant-colony-simulation/blob/86c7974afc16431838be1e629e38719b1205f07b/LICENSE) file for details.
diff --git a/assets/simulation.gif b/assets/simulation.gif
new file mode 100644
index 0000000..d4dfd2c
Binary files /dev/null and b/assets/simulation.gif differ