diff --git a/README.md b/README.md
new file mode 100644
index 0000000..608df7c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,67 @@
+# Django Personal Portfolio
+
+## Overview
+
+Django-based personal portfolio template to showcase your skills, projects, and experiences professionally.
+
+## Features
+
+- **Project Showcase:** Display projects with images, descriptions, and links.
+- **Skills Section:** Highlight your skills and expertise.
+- **Contact Form:** Enable easy communication with visitors.
+- **Responsive Design:** Seamless experience across devices.
+
+## Getting Started
+
+1. **Clone the Repository:**
+   ```bash
+   https://github.com/zappycode/django3-personal-portfolio.git
+
+2. **Navigate to the Project Directory:**
+   ```bash
+   cd django-personal-portfolio 
+
+3. **Install Dependencies:**
+   ```bash
+   pip install -r requirements.txt
+
+4. **Run Migrations:**
+   ```bash
+   python manage.py migrate
+   
+5. **Create Superuser:**
+   ```bash
+   python manage.py createsuperuser
+   
+6. **Run the Development Server:**
+   ```bash
+   python manage.py runserver
+
+7. **Access the Admin Panel:**
+- Go to http://127.0.0.1:8000/admin/ and log in with the superuser credentials to add your projects and update your information.
+
+9. **Access the Portfolio:**
+- Visit http://127.0.0.1:8000/ to see your personal portfolio.
+
+## Customization
+### Update Personal Information:
+- Edit your information in the admin panel (http://127.0.0.1:8000/admin/) under the "Personal Information" section.
+
+### Add Projects:
+- In the admin panel, go to "Projects" to add, edit, or remove projects.
+
+### Modify Skills:
+- Update your skills in the admin panel under the "Skills" section.
+
+### Change Theme:
+- Customize the HTML, CSS, and JavaScript files in the templates and static directories to suit your preferred theme.
+
+## Contribution
+Contributions are welcome! If you have ideas for improvements or new features, feel free to open an issue or submit a pull request.
+
+## Acknowledgments
+This project was inspired by the need for a simple and customizable personal portfolio template.
+Feel free to customize this README further based on your specific project details and preferences. Good luck with your personal portfolio!
+
+
+