Loomix
المستنداتدليل المطوريندليل أداة المطور Loomix CLI

أداة Loom CLI وسجل المكونات (Loomix Registry)

أداة سطر أوامر مدمجة تتيح للمطورين تثبيت وإدارة ومزامنة الكتل المعيارية والأنماط البصرية الجاهزة مباشرة من سجل GitHub دون الحاجة لكتابة كود مخصص.

نصيحة للمطورين
استخدم الأمر loom --help لاستعراض كافة الخيارات والأوامر المتوفرة.

1. ما هو Loom CLI وسجل Loomix؟

يعمل Loom CLI كمدير حزم مخصص لمكونات متجرك. يمكنك من خلاله استعراض مئات الأنماط المصممة مسبقاً، وتثبيتها في مشروعك بأمر واحد مع تحديث تلقائي لسجلات الكتل.

  • تنزيل ومزامنة الكتل الجديدة بنقرة زر من سجل GitHub.
  • فحص توافق المكونات وتحديث ملفات التصدير تلقائياً.
  • دعم السجلات الرسمية والخاصة للشركات والفرق.
  • دمج تلقائي مع سير عمل GitHub Actions وCI/CD.
  • تثبيت كتلة معينة مباشرة في مجلد المكونات.
استعراض الكتل المتوفرة في السجل
bash
npx loom list-blocks

1.2 مزامنة الأنماط مع لوحة تحكم Strapi

كيفية تسجيل الأنماط الجديدة تلقائياً في حقول خيارات Strapi.

  • قراءة المكونات المثبتة حديثاً في مجلد blocks.
  • تحديث حقل التعداد (Enumeration) لنمط الكتلة في Strapi Schema.
  • إتاحة النمط فورياً في القائمة المنسدلة لمدير المحتوى.

2. تثبيت واستخدام Loom CLI

الأداة مدمجة داخل المستودع ويمكن تشغيلها مباشرة عبر npx أو pnpm دون أي تثبيت إضافي:

اختر الكتلة المطلوبة من سجل Loomix المتاح.

نفذ أمر التثبيت عبر CLI: npx loom add-block .

يقوم CLI بتنزيل ملفات TypeScript وتنسيقات Tailwind تلقائياً.

تحديث ملف BlockRenderer.tsx لإضافة الكتلة الجديدة لخريطة المكونات.

افتح Strapi واستمتع باستخدام النمط الجديد مباشرة.

3. تثبيت كتلة جديدة أو نمط جديد

لتثبيت نمط جديد لكتلة معينة (مثل hero أو features):

أمر تثبيت النمط المباشر
bash
npx loom add-block hero --style 4

4. هيكل مجلدات الكتل في واجهة المتجر

يتم وضع كافة الكتل المثبتة داخل المجلد src/components/blocks بتنظيم هيكلي معياري يسهل تخصيصه.

خيارات سجل الكتل الرسمي والمخصص

السجل الرسمي (Official Registry):

سجل مدار من قبل فريق Loomix يوفر أنماطاً دورية جديدة ومُختبرة متوافقة 100% مع أحدث إصدارات Next.js وTailwind.

السجل الخاص (Private Registry):

يمكن لشركتك أو فريقك إنشاء سجل كتل خاص على GitHub ومشاركته بين مشاريع العملاء المختلفة بسهولة.

هيكل شجرة ملفات الكتل المعيارية:

تنظيم دقيق للمكونات والأنماط:

هيكل شجرة ملفات السجل المكوناتي
text
src/components/blocks/
├── hero/
│   ├── HeroStyle1.tsx
│   ├── HeroStyle2.tsx
│   └── index.ts
├── features/
│   ├── FeaturesStyle1.tsx
│   └── index.ts
└── BlockRenderer.tsx

خطوات ربط سجل خاص على GitHub:

  1. أنشئ مستودعاً جديداً على GitHub باسم loomix-custom-registry.
  2. نظم الكتل في مجلدات تحتوي على كود المكونات وملف schema.json التعريفي.
  3. أضف مفتاح الوصول الخاص (Personal Access Token) في ملف .env.
  4. نفذ الأمر npx loom registry set-url لتوجيه CLI إلى سجلك الخاص.
تكوين السجل في متغيرات البيئة
env
LOOMIX_REGISTRY_URL=https://raw.githubusercontent.com/your-org/loomix-registry/main
LOOMIX_REGISTRY_TOKEN=ghp_your_secret_token_here