عن المشروع
ZenUI Library React هي مكتبة مكونات واجهة مستخدم مجانية ومفتوحة المصدر مبنية باستخدام React و Tailwind CSS. يتم تقديمها كمورد خفيف الوزن وقابل للتخصيص يهدف إلى تسريع تطوير الواجهات الأمامية. يذكر ملف README أن المكتبة محسنة للأداء، وسهلة التكامل، ولا تحتوي على تبعيات؛ ويوصف استخدامها بأنه "plug-and-play"، مما يعني أن المكونات يتم نسخها ولصقها بدلاً من تثبيتها كحزمة.
ما يدرجه ملف README:
المكونات
- أكثر من 800 مكون
- أكثر من 20 قالبًا جاهزًا
- كتل للمواقع الإلكترونية
- مجموعات للتجارة الإلكترونية
الرسوم المتحركة
- أكثر من 100 مكون متحرك
الأدوات
- أكثر من 500 أيقونة قابلة للتخصيص
- لوحة شفافية الألوان
- استخراج اللون من صورة مرفوعة (color picker)
- دليل الوسوم الدلالية لـ HTML
- مولد وظائف اختصارات لوحة المفاتيح الجاهزة (shortKey)
- مولد إعدادات Tailwind للإصدار v3
الموارد
- أكثر من 118 موردًا برمجيًا
يشير المشروع أيضًا إلى معرض لقوالب المواقع وبرنامج يمكن من خلاله للمبدعين بيع قوالب React أو Next.js أو Tailwind CSS في ZenUI Library، مع عمولة معلنة بنسبة 80% لكل عملية بيع ودليل تقديم منفصل.
التثبيت للتطوير المحلي
قم بعمل Clone للمستودع، ثم انتقل إلى دليل المشروع، وقم بتثبيت التبعيات باستخدام npm install، ثم ابدأ التشغيل عبر npm run dev.
التوثيق والاستخدام
يتم توثيق مكونات ZenUI في مكتبة ZenUI عبر الإنترنت. سير العمل هو: ابحث عن المكون، انسخ مقتطف الكود، والصقه في أي مكان يتم فيه قبول علامات HTML أو JSX. لا توجد خطوة تكوين مطلوبة للاستخدام الأساسي. كل مكون مبني من فئات Tailwind CSS، لذا يتم تعريف زر مثال، على سبيل المثال، بالكامل باستخدام فئات مساعدة للحشو، ولون الخلفية، ولون النص، والزوايا المستديرة، وحالة التمرير (hover)، ويعمل بدون props. نظرًا لأن التنسيق يعتمد على الفئات، يتم تخصيص المكونات عن طريق تحرير أو إضافة الفئات: تغيير ألوان الخلفية، أو ضبط الحشو، أو زيادة نصف قطر الحدود عن طريق تبديل القيم في قائمة الفئات. يمكن تطبيق أدوات Tailwind إضافية لتأثيرات مثل الظلال والانتقالات.
أفضل الممارسات المقترحة في README
ابدأ بالمكون الافتراضي لفهم سلوكه قبل التخصيص؛ اتبع نهج Tailwind "utility-first" بدلاً من إعادة كتابة CSS؛ واحتفظ بملاحظات حول التعديلات التي أجريت على المكونات القياسية لتسهيل الصيانة.
المشروع والمجتمع
- الترخيص: MIT
- المساهمة: المساهمات المجتمعية مرحب بها، مع وجود ملف CONTRIBUTING.md في المستودع
- بيع القوالب: يتم تغطية الإرشادات وخطوات التقديم ومعلومات الأرباح في ملف TEMPLATE_SUBMISSION_GUIDE.md
- الروابط: الموقع الإلكتروني react-ui.zenui.net، بالإضافة إلى قنوات X (تويتر)، وLinkedIn، وFacebook، وDiscord
- الدعم: يتوفر رابط Ko-fi
لا يذكر ملف README أي معايير أداء (benchmarks)، أو إصدارات للحزم بخلاف ذكر مولد إعدادات Tailwind v3، أو تفاصيل حول دعم المتصفحات.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.