diff --git a/partner_geolocation_map/README.md b/partner_geolocation_map/README.md
new file mode 100644
index 0000000..7a98da9
--- /dev/null
+++ b/partner_geolocation_map/README.md
@@ -0,0 +1,72 @@
+# Smart Geolocation for Contact Forms
+
+![Beta](https://img.shields.io/badge/maturity-Beta-yellow.png) ![License](https://img.shields.io/badge/licence-LGPL--3-blue.png) [![GitHub](https://img.shields.io/badge/github-GitHubRepo-lightgray.png?logo=github)](https://github.com/Burnaviour/devtoolschool/tree/18.0/partner_geolocation_map)
+
+🚀 **Just Launched: Supercharge Your Contact Forms with Smart Geolocation!**
+
+An open-source Odoo module that enhances address inputs by making them **smarter** and **more efficient** with geolocation features! 🗺️
+
+## What It Does:
+✅ **Search & Save Locations:** Users can quickly search for any location and save it for future use.
+✅ **Auto-Fill Magic:** Selecting a saved location auto-populates address fields (city, state, ZIP, etc.).
+✅ **Drag & Discover:** Drag the map pointer anywhere, and the address fields update in real-time!
+
+## Table of Contents
+- [Usage](#usage)
+- [Example of JSON Fields](#example-of-json-fields)
+- [Demo](#demo)
+- [Bug Tracker](#bug-tracker)
+- [Credits](#credits)
+
+## Usage
+
+To integrate the Smart Geolocation module:
+
+1. Navigate to the **Contacts** module in Odoo.
+2. Use the address input field enhanced with geolocation.
+3. Select a location to auto-populate the address fields.
+4. Drag the map pin for precise adjustments.
+
+## Example of JSON Fields
+
+This module stores geolocation data in JSON format for better flexibility. Example field:
+
+```xml
+<field name="coordinates" widget="partner_geolocation_map"/>
+```
+
+## Demo
+Try out the Smart Geolocation module now! Check out our **Demo Video** 
+
+
+
+
+https://github.com/user-attachments/assets/4df15688-524d-44f5-8457-7ff09fa42f1c
+
+
+
+## Bug Tracker
+
+Bugs are tracked on [GitHub Issues](https://github.com/Burnaviour/devtoolschool/issues). If you find an issue, please report it by providing a detailed description.
+
+## Credits
+
+### Authors
+
+- Muhammad Muzafar
+
+### Contributors
+
+- Muhammad Muzafar
+- Manuel Vinent Guilarte
+
+### Maintainers
+
+This module is actively maintained. You are welcome to contribute!
+
+For any inquiries, reach out to us:
+
+📧 **Email:** [burnaviour7890@gmail.com](mailto:burnaviour7890@gmail.com)
+
+🔗 **LinkedIn:** [Muhammad Muzafar](https://www.linkedin.com/in/muhammad-muzafar-78147b213/)
+