diff --git a/.github/Origami.svg b/.github/Origami.svg
new file mode 100644
index 00000000..40c80afe
--- /dev/null
+++ b/.github/Origami.svg
@@ -0,0 +1,6 @@
+<svg width="300" height="300" viewBox="0 0 300 300" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M149.634 176.85L30 65.6503H101.267C113.223 65.6503 124.79 69.899 133.904 77.6381L213.401 145.145L182.293 176.253C173.34 185.206 158.908 185.47 149.634 176.85Z" fill="#E64554"/>
+<path d="M215.478 143.07L187.916 119.19C178.697 111.203 178.623 96.923 187.759 88.8405L215.478 64.3183V143.07Z" fill="#E64554"/>
+<path d="M145.46 177.591L118.674 152.27V236.354L145.198 212.035C155.264 202.805 155.384 186.973 145.46 177.591Z" fill="#E64554"/>
+<path d="M218.167 63.646L218.167 88.8034C218.167 103.536 230.11 115.479 244.843 115.479H270L218.167 63.646Z" fill="#E64554"/>
+</svg>
diff --git a/README.md b/README.md
index c866cc59..7160499e 100644
--- a/README.md
+++ b/README.md
@@ -1,18 +1,53 @@
-## Origami
+<!-- markdownlint-disable -->
+<div align="center">
+  <img src=".github/Origami.svg" height="128">
+</div>
+<div align="center">
+<br />
+<!-- markdownlint-restore -->
 
-### The magic of origami is in seeing a single piece of cairo evolve into a masterpiece through careful folds.
+<a href="https://twitter.com/dojostarknet">
+<img src="https://img.shields.io/twitter/follow/dojostarknet?style=social"/>
+</a>
+<a href="https://github.com/dojoengine/dojo">
+<img src="https://img.shields.io/github/stars/dojoengine/dojo?style=social"/>
+</a>
 
-### Easy Integration into Your Project
+[![discord](https://img.shields.io/badge/join-dojo-green?logo=discord&logoColor=white)](https://discord.gg/PwDa2mKhR4)
+![Github Actions][gha-badge] [![Telegram Chat][tg-badge]][tg-url]
+
+[gha-badge]: https://img.shields.io/github/actions/workflow/status/dojoengine/dojo/ci.yml?branch=main
+[tg-badge]: https://img.shields.io/endpoint?color=neon&logo=telegram&label=chat&style=flat-square&url=https%3A%2F%2Ftg.sumanjay.workers.dev%2Fdojoengine
+[tg-url]: https://t.me/dojoengine
+
+</div>
+
+# Origami - Primitives for onchain Gaming
+
+#### "The magic of origami is in seeing a single piece of cairo evolve into a masterpiece through careful folds" - Sensei
+
+---
+
+### Crates
+
+- [algebra](./crates/src/algebra)
+- [defi](./crates//src/defi/)
+- [hex map](./crates/src/map/hex)
+- [random](./crates/src/random)
+- [security](./crates/src/security)
+
+### Easy integration into your project
 
 Incorporate `origami` seamlessly into your projects using Scarb.toml.
 
 Add the following to your `[dependencies]`:
 
-```
+```toml
+[dependencies]
 origami = { git = "https://github.com/OpenZeppelin/cairo-contracts.git" }
 ```
 
-Now you will be able to use origami like any other Cairo package.
+Now you will be able to use origami like any other Cairo package!
 
 ### 🏗️ Join Our Contributors