ربط Lovable مع GitHub — دليل عربي كامل للمزامنة الثنائية
شرح تطبيقي لربط Lovable مع GitHub: اتصال Workspace، ربط Repository، المزامنة الثنائية، النسخ الاحتياطي، العمل المحلي، الفروع وطلبات الدمج، حلّ التعارضات، النشر خارج Lovable، ومتى لا تحتاج GitHub أساسًا.
١) اتصال Workspace
افتح قائمة (+) في أسفل يسار محرّر Lovable → GitHub → Connect project. Lovable سيطلب صلاحية تثبيت تطبيق GitHub (Lovable GitHub App) على حسابك أو منظّمتك. لا تعطِ صلاحيات على كلّ المستودعات إذا لم تحتج — اختر «Only select repositories». لكلّ Workspace في Lovable حساب GitHub واحد فقط في الوقت الراهن.
٢) ربط Repository
بعد التصريح، اضغط «Create Repository» داخل Lovable لإنشاء مستودع جديد باسم المشروع تلقائيًّا. Lovable لا يدعم حاليًّا استيراد مستودع موجود مباشرة — لو أردت ذلك، أنشئ المشروع في Lovable، اربطه بمستودع جديد، ثمّ انسخ ملفّات المستودع القديم يدويًّا (أو ابدأ Fresh وأعد الأجزاء الأساسية عبر البرومبت).
٣) المزامنة الثنائية
أيّ تعديل تجريه في Lovable يُدفع تلقائيًّا إلى GitHub خلال ثوانٍ، وأيّ Push إلى الفرع الافتراضي من جهازك أو من GitHub Web يُسحب فورًا إلى Lovable. لا تحتاج زرّ Pull أو Push يدوي. لاحظ: المزامنة على الفرع الافتراضي (main عادةً)؛ التعديل على فروع أخرى لن يظهر في المعاينة حتى تُدمَج.
٤) النسخ الاحتياطي
GitHub يمنحك نسخة كاملة من الكود مع سجلّ كامل للتعديلات (Commits) لكلّ رسالة أرسلتها لـLovable. لتنزيل نسخة محلّية: افتح المستودع → Code → Download ZIP، أو استخدم git clone. للحصول على بيانات قاعدة البيانات، افتح Cloud → Advanced settings → Export data داخل Lovable — قاعدة البيانات لا تُصدَّر مع كود GitHub.
٥) العمل المحلي
استنسخ المستودع (git clone)، شغّل npm install، ثمّ npm run dev. المشروع مبني على TanStack Start + Vite ويعمل على localhost:5173 محلّيًّا. لتشغيل الأجزاء التي تعتمد على Lovable Cloud تحتاج متغيّرات البيئة (VITE_SUPABASE_URL، VITE_SUPABASE_PUBLISHABLE_KEY) — انسخها من إعدادات المشروع. أيّ تعديل تدفعه (git push) يظهر في Lovable مباشرة.
٦) الفروع وطلبات الدمج
دعم الفروع في Lovable لا يزال تجريبيًّا. لتفعيله: Account Settings → Labs → GitHub Branch Switching. بعد التفعيل تستطيع التنقّل بين الفروع من داخل Lovable. الطريقة العملية للفريق: أنشئ فرعًا محلّيًّا لكلّ ميزة (git checkout -b feature/x)، ادفعه، افتح Pull Request في GitHub، راجع، ثمّ Merge إلى main — عندها تظهر التعديلات في معاينة Lovable.
٧) تعارضات المزامنة
التعارض يحدث حين تعدّل نفس الملفّ في Lovable ومحلّيًّا في نفس الوقت. Lovable سيوقف المزامنة ويعرض تحذيرًا. الحلّ: افتح المستودع محلّيًّا، شغّل git pull، حلّ التعارض يدويًّا في المحرّر، ثمّ git push. تجنّبه أصلًا بقاعدة بسيطة: عدّل من مكان واحد فقط في اللحظة الواحدة — إمّا Lovable أو محلّيًّا، لا كلاهما.
٨) النشر خارج Lovable
الكود في GitHub قياسي (TanStack Start + React + Vite) ويعمل على أيّ منصّة تدعم Node/Edge: Cloudflare Pages، Vercel، Netlify. اضبط أمر البناء (npm run build) ومجلّد المخرجات (dist أو .output حسب الإعداد)، وأضف متغيّرات البيئة نفسها. لاحظ: بعض ميزات Lovable المدارة (المصادقة المُهيّأة، AI Gateway، Email من نطاقك) ستحتاج إعدادًا يدويًّا خارج بيئة Lovable.
٩) متى لا تحتاج GitHub؟
إن كنت مبتدئًا وتبني منتجًا واحدًا لوحدك، وتنشره من Lovable مباشرة، وتستخدم version history المدمج في Lovable للتراجع — لا تحتاج GitHub الآن. أضفه لاحقًا حين: (أ) دخل فريق معك، (ب) أردت تشغيل CI/CD أو GitHub Actions، (ج) أردت النشر خارج Lovable، (د) أردت نسخة احتياطية خارج المنصّة. البدء بدون GitHub خيار مشروع وليس تقصيرًا.
قائمة تحقّق سريعة
المستودع مربوط والمزامنة تعمل باتّجاهين، الفرع الافتراضي main، ملفّ .env محلّي مضاف إلى .gitignore (لا ترفع المفاتيح!)، تنزيل الكود من Code → Download ZIP يعمل، وتشغيل npm run dev محلّيًّا يفتح المشروع بدون أخطاء. عند اكتمال هذه القائمة، اتصالك بـGitHub جاهز للإنتاج.
- هيرو تحريري لصفحة هبوطهيرو مقسّم 8/4 بدون تدرّجات، بأسلوب Stripe/Linear.
هل كان هذا المحتوى مفيداً؟
استلم أحدث الأدلّة والبرومبتات كل أسبوع
خلاصة عربية أسبوعية عن Lovable وVibe Coding — بلا سبام، إلغاء متى شئت.