عن المشروع

Lightswind UI هي مكتبة مكونات React مكتوب ملف README الخاص بها باللغة الإنجليزية. تعتمد نموذج توزيع الكود المصدري: حيث يتم تثبيت المكونات في مشروع المستخدم من خلال Lightswind CLI بدلاً من استيرادها من حزمة تشغيل. يروج المشروع لأكثر من 160 مكوناً متحركاً وسهل الوصول، ويصنفها إلى فئات مثل العناصر ثلاثية الأبعاد (3D)، والخلفيات، والمكونات المتقدمة، والأزرار، وتأثيرات النصوص، وتأثيرات المؤشر، ونواة واجهة المستخدم (UI core)، وعناصر التحكم في النماذج، والتخطيط/التنقل. المتطلبات المذكورة هي Node.js 18 أو أحدث، وReact 18 أو 19، وTailwind CSS v3 أو v4، ومشروع Next.js أو Vite أو Remix أو CRA. يدعم CLI أوامر init وadd وlist وتوثيق Pro وأوامر MCP. يقوم CLI باكتشاف أطر العمل، وحل المتطلبات المسبقة للمكونات، وتثبيت الأدوات المساعدة المشتركة، وتسجيل إضافة Tailwind. يوضح ملف README أن المكونات توجد في components/lightswind ويجب استيرادها من المسارات المحلية. تقوم إضافة Tailwind بتسجيل متغيرات CSS، وإطارات الرسوم المتحركة الرئيسية، ورموز الوضع الداكن، ونظام تأثيرات 3D اختياري. يفتح ترخيص Pro المكونات المميزة، وقوالب الصفحات، وتوصيل CLI وMCP الموثق؛ كما يمكن تعيين مفاتيح الترخيص عبر متغير بيئة لعمليات CI/CD. خادم MCP مخصص لمساعدي البرمجة بالذكاء الاصطناعي مثل Cursor وClaude وGitHub Copilot. ومن خلال أدوات MCP، يمكن للمساعدين سرد المكونات والبحث عنها، وسرد الفئات، وجلب المصدر وأدلة التثبيت، والحصول على أمثلة الاستخدام، والوصول إلى كتل Pro عند توفر الترخيص. يتضمن ملف README أمثلة تكوين لتكاملات Cursor وWindsurf وClaude Desktop وVS Code. الترخيص هو MIT للمستودع كما هو مذكور، مع محتوى Pro منفصل. يوفر المشروع أيضاً تكويناً تلقائياً لـ MCP عبر npx lightswind mcp init. يحذر ملف README وكلاء الذاء الاصطناعي من الاستيراد مباشرة من حزمة lightswind وعدم الإشارة إلى مكون provider أو مخرجات بناء node_modules. بشكل عام، تستهدف المكتبة مطوري React الذين يرغبون في مكونات مصدرية قابلة للتعديل وسير عمل تثبيت مدعوم بالذكاء الاصطناعي.