Upgrade Guide

🔹 چرا Upgrade مهمه؟

Tailwind هر چند وقت یک بار نسخه جدید منتشر می‌کنه که شامل:

  • ویژگی‌های جدید ✨

  • بهبود عملکرد ⚡

  • رفع باگ‌ها 🛠️

  • حذف قابلیت‌های قدیمی ❌

برای استفاده از بهترین امکانات و امنیت بیشتر، باید پروژه رو به نسخه جدید ارتقا بدی.

🔹 بررسی نسخه فعلی

برای دیدن نسخه‌ای که استفاده می‌کنی:

npm list tailwindcss

یا در فایل package.json بخش dependencies رو ببین.

🔹 ارتقا به آخرین نسخه

برای آپدیت مستقیم به جدیدترین نسخه:

npm install -D tailwindcss@latest postcss@latest autoprefixer@latest

📌 این دستور سه پکیج اصلی Tailwind رو با آخرین نسخه نصب می‌کنه.

🔹 تنظیم فایل config

بعد از ارتقا، ممکنه ساختار فایل tailwind.config.js تغییر کرده باشه.
برای ساخت فایل کانفیگ جدید (به‌روز):

npx tailwindcss init

📌 اگه فایل قدیمی داری → باید تغییرات لازم رو دستی اعمال کنی.

🔹 تغییرات مهم بین نسخه‌ها (مثال)

از v2 → v3

  • سیستم Just-in-Time (JIT) به صورت پیش‌فرض فعاله ✅

  • بعضی کلاس‌ها تغییر نام دادن ❌

  • پشتیبانی IE11 حذف شد ❌

از v3 → v3.4+

  • بهبود سرعت Build

  • اضافه شدن ویژگی‌های جدید مثل Container Queries

🔹 تست پروژه بعد از Upgrade

بعد از ارتقا، حتماً این مراحل رو انجام بده:

  1. پروژه رو build کن:

npm run build

  1. مرورگر رو باز کن و بخش‌های مختلف سایت رو تست کن.

  2. اگه کلاس یا فیچری کار نکرد، Release Notes رو بخون.

🔹 نکته مهم

  • همیشه قبل از Upgrade → پروژه رو Git Commit کن تا بتونی برگردی.

  • از Upgrade Guide رسمی Tailwind کمک بگیر.

  • برای پروژه‌های بزرگ بهتره ارتقا رو مرحله‌به‌مرحله انجام بدی.