مشاريعيalhanashi

أدوات تطوير

نوّار — أداة سطر أوامر

نوّار أداة سطر أوامر تختصر إعداد أي مشروع جديد إلى أمر واحد: تولّد هيكل الملفات، وتضبط أدوات الجودة، وتزرع الإعدادات المشتركة بين المشاريع بصيغة موحّدة.

الحالة
نشط
فترة التطوير
المستودع
GitHub
واجهة أداة نوّار داخل نافذة طرفية تعرض خطوات إنشاء مشروع جديد

المشكلة

بدء أي مشروع جديد كان يستهلك ساعات في إعادة تجهيز الأمور نفسها: هيكل المجلدات، أدوات الفحص والتنسيق، إعدادات TypeScript، وقوالب الاختبارات. ومع تكرار العملية يدويًا كانت الإعدادات تتباين بين مشروع وآخر، فيصعب الانتقال بينها.

الفكرة

بدل قالب جامد واحد، بُنيت الأداة على وصفات (recipes) قابلة للتركيب: تختار ما يحتاجه المشروع فتُدمج الوصفات معًا وتُولَّد الملفات النهائية. الوصفات نفسها ملفات عادية داخل المستودع، فإضافة وصفة جديدة لا تتطلب تعديل نواة الأداة.

أهم الخصائص

  • توليد هيكل مشروع كامل بأمر واحد خلال ثوانٍ.
  • وصفات قابلة للتركيب: TypeScript، اختبارات، أدوات فحص، CI.
  • وضع تفاعلي يسأل عن الخيارات، ووضع صامت يصلح للأتمتة.
  • تحديث مشروع قائم دون المساس بالملفات المعدّلة يدويًا.
  • تحقق من الإعدادات وتنبيه عند تعارضها.

التقنيات المستخدمة

  • TypeScript
  • Node.js
  • Commander
  • Vitest

البنية التقنية

نواة صغيرة مسؤولة عن قراءة الوصفات ودمجها وحلّ التعارضات، فوقها طبقة عرض لسطر الأوامر. كل وصفة تصف ملفاتها وتبعياتها ونقاط دمجها بصيغة معلنة، والكتابة على القرص تمر عبر طبقة واحدة تدعم وضع المعاينة قبل التنفيذ.

لقطات من المشروع

شاشة اختيار الوصفات في الوضع التفاعلي
الوضع التفاعلي: اختيار الوصفات قبل التوليد
معاينة الملفات التي ستُكتب قبل تنفيذ الأمر
وضع المعاينة يعرض التغييرات قبل كتابتها

هذا مشروع تجريبي ببيانات مبدئية لعرض شكل الصفحة. استبدل محتواه بمشروعك الحقيقي.

يمكن إضافة أي شرح إضافي هنا بصيغة Markdown: قرارات تقنية، دروس مستفادة، أو خطوات الاستخدام. هذا القسم اختياري بالكامل — احذفه إن لم تحتج إليه.