منصوبے کے بارے میں

Appica UI ایک کمپوننٹ لائبریری پروجیکٹ ہے جس کا مقصد accessible، جدید ویب ایپلی کیشنز اور قابلِ توسیع (scalable) ڈیزائن سسٹمز کی تعمیر ہے۔ README اسے "خوبصورتی سے اسٹائل شدہ" UI کے طور پر بیان کرتا ہے جو "جدید ویب کے لیے انسانوں کے ذریعے ڈیزائن کیا گیا ہے،" اور ان کمپوننٹس کو AI سے چلنے والی ایپس، SaaS ڈیش بورڈز، ای کامرس سائٹس اور ڈیزائن سسٹمز میں استعمال کے لیے موزوں قرار دیتا ہے۔ ریپوزٹری میں کیا شامل ہے: - ایک monorepo ڈھانچہ: فریم ورک کے مخصوص پیکیجز `packages/` کے تحت موجود ہیں، اور ہر پیکیج کو npm پر آزادانہ طور پر شائع کیا جاتا ہے۔ README لکھتے وقت ایک ہی پیکیج، `@appica/ui-react` (React implementation) درج ہے۔ - 70 سے زیادہ themeable components کا ایک سیٹ۔ نمایاں خصوصیات میں بہتر interactions، dark mode، اور مکمل theming شامل ہیں، جبکہ accessibility کو ایک بنیادی مقصد قرار دیا گیا ہے۔ - ہر پیکیج کے لیے documentation، changelog اور source کے لنکس موجود ہیں، تاکہ ہر پیکیج کو npm اور ریپوزٹری میں الگ سے ٹریک کیا جا سکے۔ ڈاکیومنٹیشن اور ڈیزائن وسائل: - مکمل ڈاکیومنٹیشن، کمپوننٹ ڈیموز اور theming گائیڈز appica.dev/ui پر ہوسٹ کی گئی ہیں، جس میں React پیکیج کے لیے انسٹالیشن پیج بھی شامل ہے۔ - ایک مفت Figma کمیونٹی ڈیزائن فائل کمپوننٹس کی نقل کرتی ہے جس میں وہی variants، sizes اور states ہیں، اور یہ انہی ڈیزائن ٹوکنز پر مبنی ہے جو کوڈ میں استعمال ہوئے ہیں۔ README اسے ڈیزائن اور ڈویلپمنٹ کے لیے ایک واحد 'source of truth' کے طور پر پیش کرتا ہے۔ پروجیکٹ اور کمیونٹی: - یہ پروجیکٹ MIT لائسنس کے تحت ہے، اور README کے مطابق اسے ذاتی اور تجارتی پروجیکٹس میں استعمال کرنا مفت ہے۔ - ریلیز کے اعلانات، نئے کمپوننٹس اور پری ویوز X پر @Appica_dev اکاؤنٹ کے ذریعے شیئر کیے جاتے ہیں۔ - ڈویلپمنٹ سیٹ اپ اور ورک فلو کی رہنمائی CONTRIBUTING.md میں فراہم کی گئی ہے۔ پڑھنے والوں کے لیے نوٹ: README میں "70+" کے علاوہ کمپوننٹس کی تعداد، براؤزر سپورٹ میٹرکس، bundle sizes، TypeScript types، SSR رویے، یا React کے علاوہ کسی اور فریم ورک کی کوریج کی دستاویز موجود نہیں ہے، لہذا ان تفصیلات کی تصدیق منسلک ڈاکیومنٹیشن یا سورس پیکیج سے کی جانی چاہیے۔ ریپوزٹری کا نام (appica-ui) اور npm scope (@appica/ui-*) ظاہر کرتے ہیں کہ اس لائبریری کو وقت کے ساتھ مزید فریم ورک پیکیجز تک بڑھانے کا ارادہ ہے۔