diff --git a/README.md b/README.md
index 53335e3..2f6bd9d 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,50 @@
-# TranslucentWindow
\ No newline at end of file
+#
Translucent Window Mod
+
+## ✨ Enhance Your Minecraft Window with a Translucent Effect! ✨
+
+### **Description**
+
+**Translucent Window** is a Fabric mod that enhances Minecraft's aesthetics by applying **translucent window effects**
+on supported systems. It seamlessly integrates with **Windows' Mica effect**, giving the game a sleek and modern look.
+
+## 🛠 Features
+
+- **Mica Effect** – Adds a soft, translucent background for a stylish visual experience.
+- **Customizable Settings** – Modify transparency, tint color, and effects via `translucent_window.json`.
+- **Optimized Performance** – Lightweight and efficient, with minimal impact on FPS.
+- **Fabric API & Java 21 Support** – Fully compatible with the latest Minecraft versions.
+
+
+
+## 📥 Installation
+
+[](https://www.curseforge.com/minecraft/mc-mods)
+[](https://modrinth.com/mod/)
+[](https://github.com/bichal)
+
+[](https://www.curseforge.com/minecraft/mc-mods/fabric-api/files)
+
+1. Install [Fabric Loader](https://fabricmc.net/use/installer/).
+2. Download the latest release from [GitHub](https://github.com/bichal/TranslucentWindow).
+3. Place the `.jar` file into your `mods` folder.
+
+## ⚙️ Configuration (Working in ConfigScreen)
+
+- The mod generates a **configuration file** in the `config` directory.
+- Edit `translucent_window.json` to adjust **transparency level, tint color, and visual effects**.
+
+## 🖥 Compatibility
+
+[](https://www.curseforge.com/minecraft/mc-mods/fabric-api/files)
+[](https://www.microsoft.com/es-es/software-download/windows11?msockid=20d7e51e0f2b68b81b24f0b20e2d69f3)
+[](https://github.com/bichal/TranslucentWindow/issues/new)
+
+## 📜 License
+
+This mod is licensed under **CC-BY-NC-4.0**.
+
+[](https://github.com/bichal/BetterPlayerLocatorBar/issues)
+[](https://buymeacoffee.com/bichal)
+[](https://ko-fi.com/bichal)
+
+💙 Created by Bichal – Enjoy your enhanced Minecraft's window experience! 💙