انتقل إلى المحتوى

سطر الأوامر

احصل على Ritla UI

كل أوامر ritla وخياراتها: init وadd وdiff وupdate وlogin وscan، وما يحفظه ritla.json، ورموز الخروج لبيئة CI.

الأوامر#

الأمرما يفعلهخيارات مفيدة
ritla initيتعرّف على Next.js أو Vite وTailwind 4 والاسم المستعار للاستيراد، ويكتب ritla.json، ويثبّت @ritla/core ويستورد أنماطه، ويسألك كيف ينتقل تطبيقك إلى الوضع الداكن وأي الخطوط يستخدم، ويثبّت رموز التصميم للثيم إذا كان مفتاح الترخيص مضبوطًا. ولتغيير المجلدات عدّل ritla.json يدويًا: لا يوجد خيار للمجلدات بعد.--css <path>، --dark class|data-theme|system، --font ritla|app، --strict، --skip-theme، --force، --no-install
ritla add <item...>يضيف المكوّنات واعتمادياتها: الملفات وحزم npm والأنماط.--overwrite، --dry-run، --no-install، --own-theme (مع style-strict وحده)
ritla diff [item...]يقارن مكوّناتك بالسجل ويعرض الفرق.--check (ينتهي برمز الخروج 1 إذا توفّر تحديث)
ritla update [item...]يطبّق تغييرات السجل على الملفات التي لم تعدّلها، ويضيف أي عنصر من السجل صارت مكوّناتك تعتمد عليه.--force، --dry-run
ritla loginيرشدك إلى مكان حفظ مفتاح الترخيص، ويفحص الإعداد.
ritla scan --project <id>يشغّل فحص ريتلا ويفشل إذا وجد ملاحظات بالخطورة المحددة أو أعلى. مخصص لـ CI.--fail-on، --timeout، --json

كل الأوامر تقبل --cwd <path> و--help.

كل مكوّن يقرأ الثيم، فثبّته قبل أول مكوّن: npx ritla init ومفتاح الترخيص مضبوط، أو npx ritla add style. وإن تخطّيته وصلت المكوّنات عناصر بلا تنسيق، دون أي رسالة خطأ.

التطبيقات القائمة والوضع الصارم#

يضيف الثيم أسماءه بجانب قيم Tailwind الافتراضية ولا يغيّر أي صنف من أصنافك، فتعمل init وadd وupdate في تطبيق قائم كما تعمل في تطبيق جديد. وأي كتلة @theme خاصة بك تبقى تعمل بجانبه، ما لم تعرّف اسمًا يطابق تمامًا أحد أسماء الثيم (رموز التصميم).

أما ritla init --strict، أو ritla add style-strict لاحقًا، فيضيف ملف الأنماط الاختياري للوضع الصارم، فيحذف مقاييس Tailwind الافتراضية ويضيف الأنماط الأساسية للثيم: عائلة الخط، وإلغاء تباعد الحروف في العربية، وحلقة التركيز، ومدة الحركة ومنحناها على كل transition مجرّد. لا تستخدمه إلا في تطبيق جديد أو تخطيط مخصّص. وإن كانت في ملف أنماطك كتلة @theme خاصة بك، يتوقف ritla add style-strict برمز الخروج 1 ولا يكتب شيئًا، لأن الوضع الصارم سيستبدل ذلك الثيم؛ مرّر --own-theme لتسمح له بذلك، أو استغنِ عن الوضع الصارم. ويُعدّ ritla init --strict موافقة على ذلك. راجع الوضع الصارم.

ملف ritla.json#

يكتب init الملف ritla.json ويُحفظ مع المشروع. فيه الأسماء المستعارة والمجلدات التي تشير إليها وملف الأنماط، وإجابتاك عن الوضع الداكن والخطوط (dark وfont)، وبصمة لكل ملف كتبه add، وبها يميّز diff وupdate بين تغيير في السجل وتعديلك أنت. ولا يحتوي على أي مفتاح.

الأمر ritla scan في CI#

يقرأ ritla scan مفتاح API للفحص (أنشئه من الإعدادات في لوحة التحكم) من RITLA_API_KEY، وهو سرّ مختلف عن مفتاح الترخيص.

npx ritla scan --project <id> --fail-on high
رمز الخروجمعناه
0نجح.
1ملاحظات بالخطورة المحددة أو أعلى.
2خطأ في الاستخدام أو الإعداد.
3تعذّر الفحص: رُفض أو فشل أو انتهت مهلته.

انتهاء المهلة فشل، وليس نجاحًا أبدًا.

على GitHub، يشغّل إجراء الفحص الفحص نفسه في خطوة من سير العمل.