عن المشروع

Appica UI هو مشروع مكتبة مكونات يهدف إلى بناء تطبيقات ويب حديثة وسهلة الوصول وأنظمة تصميم قابلة للتوسع. يصف ملف README المشروع بأنه واجهة مستخدم "منسقة بجمال" و"مصممة من قبل بشر للويب الحديث"، ويوجه المكونات للاستخدام في التطبيقات المدعومة بالذكاء الاصطناعي، ولوحات تحكم SaaS، ومواقع التجارة الإلكترونية، وأنظمة التصميم. محتويات المستودع: - هيكل monorepo: توجد الحزم الخاصة بإطارات العمل تحت `packages/` ويتم نشر كل حزمة على npm بشكل مستقل. في وقت كتابة README، تدرج القائمة حزمة واحدة وهي `@appica/ui-react` (تنفيذ React). - مجموعة مكونات تضم أكثر من 70 مكوناً قابلاً للتخصيص. وتتمثل أبرز الميزات المذكورة في التفاعلات المصقولة، والوضع الليلي، والتخصيص الكامل الجاهز للاستخدام، مع التأكيد على أن سهولة الوصول هي هدف أساسي. - روابط لكل حزمة للتوثيق وسجل التغييرات والمصدر، بحيث يمكن تتبع كل حزمة بشكل منفصل على npm وفي المستودع. موارد التوثيق والتصميم: - يتم استضافة التوثيق الكامل وعروض المكونات وأدلة التخصيص على appica.dev/ui، بما في ذلك صفحة تثبيت لحزمة React. - يتوفر ملف تصميم مجاني في مجتمع Figma يعكس المكونات مع متغيرات وأحجام وحالات متطابقة، مبني على نفس رموز التصميم (design tokens) المستخدمة في الكود. يقدم README هذا كطريقة للتصميم والتطوير من مصدر حقيقة واحد. المشروع والمجتمع: - المشروع مرخص بموجب MIT، وينص ملف README على أنه مجاني للاستخدام في المشاريع الشخصية والتجارية. - يتم مشاركة إعلانات الإصدارات والمكونات الجديدة والمعاينات عبر حساب @Appica_dev على منصة X. - يتم توفير إرشادات إعداد التطوير وسير العمل في ملف CONTRIBUTING.md. ملاحظات النطاق للقراء: لا يوثق ملف README أعداد المكونات بما يتجاوز "+70"، أو مصفوفات دعم المتصفحات، أو أحجام الحزم، أو أنواع TypeScript، أو سلوك SSR، أو تغطية إطارات العمل بخلاف React، لذا يجب التحقق من هذه التفاصيل من خلال التوثيق المرتبط أو حزمة المصدر نفسها. يشير اسم المستودع (appica-ui) ونطاق npm (@appica/ui-*) إلى أن المكتبة تهدف إلى التوسع لتشمل حزم إطارات عمل إضافية بمرور الوقت.