diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5d1375b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,112 @@
+
+---
+
+# CODEX61814  
+
+[![Portfolio Link](https://img.shields.io/badge/Portfolio-Website-blue?style=flat-square)](https://codex61814.xyz/)  
+![GitHub last commit](https://img.shields.io/github/last-commit/imthecode777/codex61814)  
+![GitHub repo size](https://img.shields.io/github/repo-size/imthecode777/codex61814)  
+
+## 🖥️ Overview  
+
+**CODEX61814** stands for **"CREATE OPTIMIZED DIGITAL EXCELLENCE EXPONENTIALLY WITH FAHAD"**. It represents a dedication to creating innovative, efficient, and impactful digital experiences.  
+
+This project is a personal portfolio designed to showcase my skills, projects, and achievements as a web developer. The portfolio reflects creativity, responsiveness, and high-quality design to make a lasting impression on visitors.  
+
+---
+
+## ✨ Features  
+
+- **Responsive Design**: Perfectly optimized for all screen sizes and devices.  
+- **Modern UI/UX**: Stylish and interactive design for a visually engaging experience.  
+- **Dynamic Animations**: Smooth animations using AOS (Animate On Scroll) for an appealing look.  
+- **Portfolio Showcases**: Highlights skills, completed projects, and professional achievements.  
+- **Custom Domain**: Hosted on a personal domain: [codex61814.xyz](https://codex61814.xyz/).  
+
+---
+
+## 🚀 Live Demo  
+
+Visit the portfolio live at: [**codex61814.xyz**](https://codex61814.xyz/)  
+
+---
+
+## 📂 Project Structure  
+
+```
+├── index.html         # Main HTML file  
+├── css/               # Contains all CSS files for styling  
+│   ├── styles.css     # Main stylesheet  
+│   ├── animations.css # Animation-related styles  
+├── js/                # JavaScript files for interactivity  
+│   ├── script.js      # Main JavaScript logic  
+│   ├── aos.js         # Animate On Scroll library  
+├── images/            # All images and assets used in the project  
+├── README.md          # Documentation file  
+```  
+
+---
+
+## 🔧 Technologies Used  
+
+- **HTML5**: Structuring the content  
+- **CSS3**: Styling and animations  
+- **JavaScript**: Adding interactivity  
+- **AOS Library**: For scroll-based animations  
+- **GitHub Pages**: Hosting the repository  
+
+---
+
+## 💻 Installation  
+
+To run the portfolio locally, follow these steps:  
+
+1. Clone the repository:  
+   ```bash  
+   git clone https://github.com/imthecode777/codex61814.git  
+   ```  
+
+2. Navigate to the project folder:  
+   ```bash  
+   cd codex61814  
+   ```  
+
+3. Open `index.html` in your browser to view the portfolio.  
+
+---
+
+## 📈 Future Enhancements  
+
+- Add more projects and dynamic filtering options for portfolio items.  
+- Implement contact form functionality with backend integration.  
+- Enhance animations and introduce Web 3.0 concepts to showcase advanced development trends.  
+
+---
+
+## 🛠️ Contributing  
+
+Contributions are welcome! If you have ideas to enhance this project, feel free to:  
+1. Fork the repository.  
+2. Create a new branch for your feature:  
+   ```bash  
+   git checkout -b feature-name  
+   ```  
+3. Commit your changes and push:  
+   ```bash  
+   git push origin feature-name  
+   ```  
+4. Submit a Pull Request.  
+
+---
+
+## 🤝 Contact  
+
+If you have any questions or suggestions, feel free to reach out:  
+- **Email**: [codex61814@gmail.com]  
+- **Portfolio**: [codex61814.xyz](https://codex61814.xyz/)  
+
+---
+
+**⭐ Don't forget to star the repository if you found it helpful!**  
+
+---