انتقل إلى المحتوى الرئيسي

Theme Dev

بدء خادم تطوير للقالب في منصة Qumra.

qumra theme dev​

بدء خادم تطوير للقالب.

الوصف​

هذا الأمر يبدأ خادم تطوير محلي للقالب على المنفذ 3000. يسمح لك بـ:

  • رؤية تغييرات القالب فوراً
  • مزامنة الملفات تلقائياً مع منصة Qumra
  • التطوير في بيئة تطوير حية

الاستخدام​

qumra theme dev

الخطوات التفاعلية​

عند تشغيل الأمر، سيطلب منك:

  1. اختيار التطبيق: اختر أحد التطبيقات المتاحة لاستخدامه كمصدر للبيانات
ملاحظة

يجب أن يكون لديك تطبيق واحد على الأقل متاح في حسابك.

المخرجات​

بعد اختيار التطبيق، سيتم:

  • تهيئة قالب التطبيق
  • بدء المراقبة والمزامنة التلقائية للملفات
  • بدء خادم التطوير وعرض الروابط التالية:

الروابط المتاحة:​

  1. 📡 Localhost (http://localhost:3000)

    • رابط للوصول إلى القالب محلياً على جهازك
    • يسمح لك باختبار القالب محلياً قبل النشر
    • تظهر تغييرات الملفات فوراً هنا
  2. 🌍 Theme URL (https://[store].qumra.store?theme=[theme-id])

    • رابط للقالب على المتجر الحقيقي
    • يستخدم لاختبار القالب في بيئة حقيقية
    • يمكنك مشاركته مع الآخرين لمعاينة القالب
  3. 📦 Customize Theme (https://app.qumra.cloud/store/[store]/themes/[theme-id])

    • رابط لفتح القالب في لوحة التحكم
    • يسمح لك بتعديل القالب من المتصفح
    • يمكنك استخدام محرر الكود المدمج في اللوحة

مثال​

$ qumra theme dev
? Select the app you want to use as a data source: (Use arrow keys)
❯ My Store (mystore)
Another Store (anotherstore)

🚀 Server started successfully!

📡 Localhost => http://localhost:3000
🌍 Theme URL => https://the-one.qumra.store?theme=6919bd44929486cfccb1f892
📦 Customize Theme => https://app.qumra.cloud/store/the-one/themes/6919bd44929486cfccb1f892

المتطلبات​

  • يجب أن تكون داخل مجلد قالب موجود
  • يجب أن يكون لديك تطبيق واحد على الأقل في حساب Qumra الخاص بك
  • يجب أن يكون ملف qumra.config.json موجوداً في المجلد

نصائح​

استخدام الروابط
  • Localhost: استخدمه للتطوير المحلي السريع ومعاينة التغييرات الفورية
  • Theme URL: استخدمه لاختبار القالب في بيئة حقيقية أو مشاركته مع الآخرين
  • Customize Theme: استخدمه لتعديل القالب من المتصفح دون الحاجة لفتح محرر كود
نصيحة
  • استخدم Ctrl+C لإيقاف خادم التطوير
  • ستتم مزامنة تغييرات الملفات تلقائياً
  • تأكد من اتصالك بالإنترنت للمزامنة مع المنصة
  • يمكنك استخدام روابط متعددة في نفس الوقت
تحذير خطير

لا تشغل أمر dev في مجلد غير مخصص لقالب Qumra. تأكد من وجود ملف qumra.config.json أولاً.


استكشاف الأخطاء وإصلاحها​

خطأ: "No apps available"​

الحل: تأكد من أن لديك تطبيقاً واحداً على الأقل في حساب Qumra الخاص بك. أنشئ تطبيقاً من لوحة التحكم أولاً.