diff --git a/README.md b/README.md
new file mode 100644
index 0000000..bca9542
--- /dev/null
+++ b/README.md
@@ -0,0 +1,108 @@
+# 🚀 Snigdha OS Core
+
+Welcome to the **Snigdha OS Core** repository! This is the heart of **Snigdha OS**, a modern, lightweight, and customizable Linux distribution based on Arch Linux. Whether you're a developer, enthusiast, or casual user, this repository provides the essential tools and configurations to get you started with Snigdha OS. 🌟
+
+
+
+## 📖 Overview
+
+Snigdha OS Core includes:
+
+- 🛠️ **Core Components**: Fundamental scripts and packages that form the backbone of Snigdha OS.
+- ⚙️ **Configuration Files**: Optimized system-level settings for performance and a great user experience.
+- 🌐 **Package Mirror**: A reliable and fast Arch Linux mirror for seamless updates and package management.
+
+
+
+## ✨ Features
+
+- 💡 **Lightweight**: Built for speed and efficiency with minimal resource usage.
+- 🎨 **Customizable**: Tailor your system to meet your specific needs.
+- 🚀 **Fast Updates**: Integrated Arch Linux mirror ensures quick and reliable package updates.
+- 🔒 **Secure**: Trusted configurations and scripts for a stable Linux experience.
+
+
+
+## 📁 Repository Structure
+
+- 📂 `x86_64/`: 64-bit packages for Snigdha OS.
+- 📜 `package-list.sh`: Script to generate the list of packages included in the distribution.
+- 📄 `packages.txt`: Text file listing all packages with their versions.
+- 📤 `push.sh`: Automates repository updates for maintainers.
+- 🔑 `repo-creds.sh`: Secure credentials management for repository operations.
+
+
+
+## 🛠️ Getting Started
+
+Follow these steps to get started with Snigdha OS Core:
+
+1. **Clone the Repository**:  
+   ```bash
+   git clone https://github.com/Snigdha-OS/snigdhaos-core.git
+   ```
+
+2. **Navigate to the Directory**:  
+   ```bash
+   cd snigdhaos-core
+   ```
+
+3. **Explore the Files**:  
+   Check out the scripts, configurations, and package lists to understand the core of Snigdha OS.
+
+4. **Run the Setup**:  
+   Use the provided scripts to initialize or contribute to the project.
+
+
+
+## 🤝 Contributing
+
+We ❤️ contributions! To contribute to Snigdha OS Core:
+
+1. **Fork the Repository**.  
+2. **Create a Feature Branch**:  
+   ```bash
+   git checkout -b feature/your-feature-name
+   ```
+
+3. **Implement Your Changes**.  
+4. **Commit Your Work**:  
+   ```bash
+   git commit -m "✨ Add: Feature description"
+   ```
+
+5. **Push to Your Fork**:  
+   ```bash
+   git push origin feature/your-feature-name
+   ```
+
+6. **Submit a Pull Request**:  
+   Open a PR describing your changes and their benefits.
+
+💡 **Tip**: Ensure your code follows our [Contribution Guidelines](https://github.com/Snigdha-OS/contributing).
+
+
+
+## 📜 License
+
+This project is licensed under the **MIT License**.  
+See the [LICENSE](https://github.com/Snigdha-OS/snigdhaos-core/blob/master/LICENSE) file for more details. 📄
+
+
+
+## 📞 Support and Contact
+
+For assistance or inquiries, reach out via:
+
+- 🌐 Website: [Snigdha OS Official](https://snigdha-os.github.io/)
+- 📚 Documentation: [Snigdha OS Docs](https://github.com/Snigdha-OS/documentation)
+- 🐞 Report Issues: Open an [Issue](https://github.com/Snigdha-OS/snigdhaos-core/issues)
+- ✉️ Email: support@snigdhaos.org
+
+
+
+## 🛡️ Disclaimer
+
+This repository is maintained actively, but please ensure you review updates before deployment. Your feedback helps us grow! 🌟
+
+Enjoy the journey with Snigdha OS! 🎉
\ No newline at end of file