diff --git a/README.md b/README.md
new file mode 100644
index 0000000..41fafe0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,137 @@
+# Snigdha OS KDE Theme 🖌️🎨
+
+Welcome to the **Snigdha OS KDE Theme** repository! This project provides a polished and elegant theme for the KDE Plasma desktop environment, meticulously designed to reflect the sleek and modern aesthetics of Snigdha OS. Whether you're a casual user or a power user, this theme ensures a visually cohesive and enjoyable desktop experience. 🌟✨
+
+
+
+## Table of Contents 📚
+- [Introduction](#introduction)
+- [Features](#features)
+- [Installation](#installation)
+- [Usage](#usage)
+- [Screenshots](#screenshots)
+- [Developer Team](#developer-team)
+- [Contributing](#contributing)
+- [License](#license)
+
+
+
+## Introduction 🖥️
+
+The **Snigdha OS KDE Theme** is crafted to offer:
+- A consistent, modern visual style 🧑‍🎨.
+- Smooth integration with Snigdha OS and its design philosophy 🧩.
+- A refined user experience that enhances productivity 🚀.
+
+With this theme, your KDE Plasma desktop will look stunning while maintaining functionality and performance.
+
+
+
+## Features 🎉
+
+### 🎨 Beautiful Design Elements
+- **Custom Color Palettes**: Thoughtfully chosen hues that balance vibrancy and subtlety.
+- **Iconography**: A set of bespoke icons tailored for a modern look.
+- **Widget Styling**: Plasma widgets have been elegantly redesigned for seamless integration.
+
+### 📐 High Compatibility
+- Works seamlessly with various KDE Plasma versions.
+- Fully responsive, ensuring a flawless appearance on all screen sizes and resolutions.
+
+### 🛠️ Easy Customization
+- Quickly adjustable through the KDE System Settings interface.
+- Options to tweak and adapt to individual preferences.
+
+
+
+## Installation ⚙️
+
+Follow these steps to install the theme:
+
+1. **Clone the Repository** 🌀:
+   ```bash
+   git clone https://github.com/Snigdha-OS/snigdhaos-kde-theme.git
+   ```
+
+2. **Navigate to the Directory** 📁:
+   ```bash
+   cd snigdhaos-kde-theme
+   ```
+
+3. **Install the Theme Files** 📂:
+   ```bash
+   cp -r ./themes/* ~/.local/share/plasma/desktoptheme/
+   ```
+
+4. **Activate the Theme** 🎛️:
+   - Open **System Settings**.
+   - Go to **Appearance** > **Global Theme**.
+   - Select **Snigdha OS Theme**.
+   - Click **Apply** to enable it.
+
+
+
+## Usage 🖱️
+
+After installation:
+- Navigate to KDE **System Settings** > **Appearance** to explore theme customization options.
+- Combine with your favorite icon packs and cursors for a personalized look.
+- Experiment with different widget layouts and discover the theme's flexibility.
+
+
+
+## Screenshots 📸
+
+*Show off how amazing this theme looks!* Add screenshots or GIFs here to demonstrate the design in action.
+
+> Coming Soon*
+
+## Developer Team 👨‍💻👩‍💻
+
+Meet the awesome team behind the **Snigdha OS KDE Theme**! 💪✨
+
+- **Snigdha OS Devs** 🧑‍🎨:
+  - 🎨 *[Eshan Roy]* – Lead Developer & Designer
+
+Special thanks to the Snigdha OS community for their support and feedback! ❤️
+
+
+
+## Contributing 🤝
+
+We ❤️ contributions! If you'd like to improve the Snigdha OS KDE Theme:
+
+1. **Fork the Repository** 🍴:
+   Click on the **Fork** button at the top of the page.
+
+2. **Create a New Branch** 🌿:
+   ```bash
+   git checkout -b feature/your-feature-name
+   ```
+
+3. **Commit Your Changes** ✍️:
+   ```bash
+   git commit -m "Add detailed commit message here"
+   ```
+
+4. **Push Your Branch** 📤:
+   ```bash
+   git push origin feature/your-feature-name
+   ```
+
+5. **Open a Pull Request** 🔁:
+   Submit your PR on the original repository and include a clear description of your changes.
+
+For detailed contribution guidelines, please refer to the [Contribution Guide](https://github.com/Snigdha-OS/documentation).
+
+
+
+## License 📜
+
+This project is licensed under the **MIT License**. Feel free to use, modify, and distribute as per the terms of the license. For more details, see the [LICENSE](https://github.com/Snigdha-OS/snigdhaos-kde-theme/blob/master/LICENSE) file.
+
+
+
+💻 *Transform your KDE Plasma desktop today with the Snigdha OS KDE Theme!*  
+🌐 For more Snigdha OS projects, visit our [website](https://snigdhaos.org) or check out other [GitHub repositories](https://github.com/Snigdha-OS).  
+👥 Join the conversation and share your feedback with our vibrant community!
\ No newline at end of file