diff --git a/README.md b/README.md
new file mode 100644
index 0000000..37ee500
--- /dev/null
+++ b/README.md
@@ -0,0 +1,10 @@
+# HTML / CSS / JS / WebSocket Stream Overlay
+
+A fully customizable overlay built with **HTML**, **CSS**, **JavaScript**, and **WebSocket**, designed to be **controlled by [Streamer.bot](https://streamer.bot/)**.
+
+## ✨ Features
+- 🎨 Dynamic HTML/CSS layout
+- ⚡ Real-time updates via WebSocket
+- 🖼️ Animated emotes and alerts
+- 📺 Video and text overlays
+- 🛠️ Easy integration with Streamer.bot actions