diff --git a/README.md b/README.md
new file mode 100644
index 0000000..eac9356
--- /dev/null
+++ b/README.md
@@ -0,0 +1,111 @@
+# 🍃 مطیب | طعم واقعی طبیعت
+
+**Motayeb** – یک تم فروشگاهی اختصاصی و مدرن برای وردپرس و ووکامرس، ویژه‌ی محصولات ارگانیک و طبیعی.
+
+## 📌 درباره پروژه
+این تم با هدف ایجاد یک فضای بصری گرم، سالم و کاربرپسند برای فروشگاه‌های محصولات ارگانیک طراحی شده است. هویت بصری آن بر پایه‌ی رنگ‌های طبیعی و حس اعتماد بنا شده و کاملاً ریسپانسیو و آماده‌ی شخصی‌سازی می‌باشد.
+
+---
+
+## ✅ وضعیت فعلی (Current Status)
+- **ساختار پایه‌ی تم** بر اساس استانداردهای وردپرس (Template Hierarchy) پیاده‌سازی شده است.
+- **فایل‌های اصلی** شامل `header`, `footer`, `index`, `page`, `single`, `archive` و `404` ایجاد شده‌اند.
+- **اوورراید اولیه‌ی ووکامرس** برای صفحات `archive-product` و `single-product` انجام شده است.
+- **رابط کاربری (UI) کامل** در فایل `ui.html` طراحی و نهایی شده است که شامل:
+  - هدر با لوگو، منوی اصلی، دارک مود، حساب کاربری و سبد خرید
+  - بخش جستجوی پیشرفته با پیشنهادات پرطرفدار
+  - هیرو (Hero) با شعار و دکمه‌های CTA
+  - نمایش آمار فروشگاه و اعتمادسازی (گواهی ارگانیک و امتیاز)
+  - دسته‌بندی محصولات با شمارش تعداد
+  - فوتر با اطلاعات تماس و دکمه‌ی تغییر زبان
+
+---
+
+## 🗺️ نقشه‌ی راه توسعه (Development Roadmap)
+
+در ادامه، برنامه‌ی گام‌به‌گام پروژه را مشخص کرده‌ایم تا با هم به بهترین شکل پیش برویم:
+
+### فاز اول: تکمیل هسته‌ی تم وردپرس (Core Setup)
+- [ ] تکمیل فایل `functions.php`:
+  - افزودن پشتیبانی از `title-tag` و `post-thumbnails`
+  - ثبت منوهای اصلی و فوتر
+  - تعریف ناحیه‌های ویجت (سایدبار و فوتر)
+- [ ] فراخوانی صحیح فایل‌های `style.css` و اسکریپت‌ها با استفاده از `wp_enqueue_scripts`
+- [ ] شخصی‌سازی صفحات پیش‌فرض وردپرس (بلاگ، برگه‌ها، نویسنده)
+
+### فاز دوم: یکپارچه‌سازی و شخصی‌سازی ووکامرس (WooCommerce Integration)
+- [ ] شخصی‌سازی صفحه‌ی محصول (`single-product.php`) – نمایش گالری، توضیحات، دکمه‌ی افزودن به سبد
+- [ ] شخصی‌سازی صفحه‌ی فروشگاه (`archive-product.php`) – نمایش گرید محصولات و سایدبار فیلترها
+- [ ] شخصی‌سازی صفحه‌ی سبد خرید (Cart) و تسویه‌حساب (Checkout)
+- [ ] تنظیم متغیرهای ووکامرس برای محصولات ارگانیک (برچسب‌ها، ویژگی‌ها)
+
+### فاز سوم: پیاده‌سازی ویژگی‌های تعاملی و فرانت‌اند (Interactive Features)
+- [ ] پیاده‌سازی عملی دارک مود (ذخیره‌سازی انتخاب کاربر در مرورگر با LocalStorage)
+- [ ] فعال‌سازی جستجوی زنده (Live Search) با Ajax
+- [ ] ساخت اسلایدر اختصاصی برای بخش هیرو (قابلیت تغییر بنرها از پنل ادمین)
+- [ ] نمایش محصولات ویژه / پرفروش‌ترین‌ها در صفحه‌ی اصلی (با استفاده از Shortcode یا Query سفارشی)
+- [ ] افزودن انیمیشن‌های ملایم برای بهبود تجربه‌ی کاربری (UX)
+
+### فاز چهارم: بهینه‌سازی، سئو و کارایی (Performance & SEO)
+- [ ] بهینه‌سازی فایل‌های `assets` (فشرده‌سازی CSS/JS و استفاده از CDN برای فونت‌ها)
+- [ ] پیاده‌سازی دیتا مارکاپ (Schema.org) برای محصولات ارگانیک و نظرات
+- [ ] افزودن قابلیت چندزبانگی (مقدمات WPML یا Polylang)
+- [ ] بهینه‌سازی تصاویر (Lazy Loading و WebP)
+- [ ] بررسی سرعت بارگذاری با ابزارهایی مثل GTmetrix و رفع گلوگاه‌ها
+
+### فاز پنجم: آزمون و انتشار (Testing & Launch)
+- [ ] تست جامع در مرورگرهای مختلف (Chrome, Firefox, Safari, Edge)
+- [ ] تست ریسپانسیو بودن در دستگاه‌های موبایل، تبلت و دسکتاپ
+- [ ] تست عملکرد ووکامرس (ثبت سفارش، درگاه پرداخت، ایمیل‌ها)
+- [ ] بسته‌بندی نهایی تم و تهیه‌ی مستندات نصب برای کاربر نهایی
+
+---
+
+## 📂 ساختار پوشه‌ها (Directory Structure)
+
+motayeb/
+├── assets/
+│ ├── css/
+│ ├── js/
+│ └── images/
+├── woocommerce/
+│ ├── archive-product.php
+│ ├── single-product.php
+│ └── (سایر فایل‌های اوورراید)
+├── header.php
+├── footer.php
+├── index.php
+├── page.php
+├── single.php
+├── archive.php
+├── front-page.php
+├── 404.php
+├── functions.php
+├── style.css
+├── screenshot.png
+└── README.md
+
+
+---
+
+## 🛠️ تکنولوژی‌های استفاده‌شده
+- **بک‌اند**: WordPress + WooCommerce (PHP)
+- **فرانت‌اند**: HTML5, CSS3, JavaScript (ES6)
+- **ابزارها**: Git برای کنترل نسخه
+
+---
+
+## 🤝 نحوه‌ی همکاری
+این پروژه به صورت مرحله‌ای پیش می‌رود. هر فاز پس از تایید و تست، به مخزن اصلی (Main Branch) ادغام خواهد شد. نظرات و ایده‌های شما برای بهبود پروژه بسیار ارزشمند است!
+
+---
+
+**🌐 آدرس مخزن:**  
+[https://www.git.vernahost.ir/gitmodir110/motayeb](https://www.git.vernahost.ir/gitmodir110/motayeb)
+
+**📧 تماس:**  
+(در صورت نیاز، اطلاعات تماس را اینجا درج کنید)
+
+---
+
+> **نکته:** این یک تم کاملاً سفارشی است و برای استفاده در فروشگاه‌های محصولات طبیعی و ارگانیک طراحی شده است.
\ No newline at end of file