diff --git a/README.md b/README.md
index 5d61633..0ae670b 100644
--- a/README.md
+++ b/README.md
@@ -13,3 +13,28 @@
 </p>
 
 # hyperweb
+
+<p align="center" width="100%">
+    <img height="90" src="https://github.com/user-attachments/assets/e629dddd-d560-45e1-b45c-5d125e3acd6a" />
+</p>
+
+<p align="center" width="100%">
+  <a href="https://github.com/hyperweb-io/hyperweb-boilerplate/actions/workflows/run-tests.yml">
+    <img height="20" src="https://github.com/hyperweb-io/hyperweb-boilerplate/actions/workflows/run-tests.yml/badge.svg" />
+  </a>
+  <br />
+   <a href="https://github.com/hyperweb-io/hyperweb-boilerplate/blob/main/LICENSE"><img height="20" src="https://img.shields.io/badge/license-MIT-blue.svg"></a>
+   <a href="https://www.npmjs.com/package/@hyperweb/core"><img height="20" src="https://img.shields.io/github/package-json/v/hyperweb-io/hyperweb-boilerplate?filename=packages%2Fcore%2Fpackage.json"></a>
+</p>
+
+# Hyperweb Boilerplate
+
+Welcome to **Hyperweb**, the blockchain for JavaScript smart contracts. Hyperweb enables developers to write decentralized applications (dApps) using TypeScript, designed for cross-chain compatibility and ease of development.
+
+## Installation
+
+1. Clone the repository:
+
+```bash
+git clone https://github.com/hyperweb-io/hyperweb-boilerplate.git
+```
\ No newline at end of file