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

coss.com/ui (سابقہ Origin UI) کو Cal.com کے آفیشل ڈیزائن سسٹم کے طور پر بیان کیا گیا ہے۔ یہ ریپوزٹری ایک monorepo ہے جس میں کئی مصنوعات اور ایپلی کیشنز شامل ہیں، جو سب TypeScript میں لکھی گئی ہیں اور Turborepo کے ذریعے منظم ہیں۔ ریپوزٹری کا لے آؤٹ monorepo میں درج ذیل ایپس اور پیکیجز شامل ہیں: - apps/www/ — مرکزی coss.com ویب سائٹ - apps/ui/ — coss ui کمپوننٹ لائبریری اور دستاویزات - apps/origin/ — پرانے Origin UI کمپوننٹس، جنہیں ایک pre-acquisition snapshot کے طور پر رکھا گیا ہے - packages/ui/ — مشترکہ UI کمپوننٹس پیکیج - packages/typescript-config/ — TypeScript کنفیگریشنز - biome.json — لنٹنگ اور فارمیٹنگ کے لیے مشترکہ Biome کنفیگریشن انوائرمنٹ ویری ایبلز (Environment variables) چونکہ کئی Next.js ایپلی کیشنز ایک دوسرے سے منسلک ہیں، اس لیے ہر ایپ کو اپنی .env.local فائل کی ضرورت ہوتی ہے تاکہ مقامی طور پر کراس ایپ نیویگیشن کام کر سکے۔ README میں www ایپ (NEXT_PUBLIC_APP_URL, NEXT_PUBLIC_COSS_UI_URL)، ui ایپ (NEXT_PUBLIC_APP_URL, NEXT_PUBLIC_COSS_URL, NEXT_PUBLIC_ORIGIN_URL) اور origin ایپ (NEXT_PUBLIC_APP_URL, NEXT_PUBLIC_COSS_URL, NEXT_PUBLIC_COSS_UI_URL) کے ویری ایبلز کی تفصیل ہے، جس میں localhost پورٹس 3000، 4000 اور 4001 کی مثالیں دی گئی ہیں۔ Turborepo .env* فائلوں کی نگرانی کرتا ہے، لہذا ان ویری ایبلز کے تبدیل ہونے پر کیش (cache) ختم ہو جاتا ہے۔ ڈیولپمنٹ ورک فلو ٹولز میں اسٹیٹک ٹائپ چیکنگ کے لیے TypeScript اور لنٹنگ اور فارمیٹنگ کے لیے Biome شامل ہیں۔ کمانڈز bun کے ذریعے چلائی جاتی ہیں: `bun run build` اور `bun run dev` سب کچھ بلڈ یا اسٹارٹ کرتے ہیں، جبکہ `--filter=www`، `--filter=ui` یا `--filter=origin` کسی ایک ایپ کو ٹارگٹ کرتے ہیں۔ coss ui کیا فراہم کرتا ہے coss ui کو Base UI پر مبنی اور Tailwind CSS سے اسٹائل شدہ قابل رسائی (accessible) اور کمپوز ایبل React components کے مجموعے کے طور پر پیش کیا گیا ہے، جسے اس طرح ڈیزائن کیا گیا ہے کہ ڈویلپرز کوڈ کو کاپی، پیسٹ اور اپنا بنا سکیں۔ README میں بتایا گیا ہے کہ Base UI کے unstyled primitives کو ایک تیار ڈیزائن سسٹم دیا گیا ہے، اور یہ وہ کمپوننٹ لائبریری ہے جسے Cal.com بتدریج اپنانے کا ارادہ رکھتا ہے۔ اس کی ڈیولپمنٹ اوپن سورس میں جاری ہے۔ Origin UI کا حصول ریپوزٹری میں Origin UI کمپوننٹس ایک لیگیسی اسنیپ شاٹ کے طور پر شامل ہیں: ایک Radix پر مبنی، shadcn-اسٹائل مجموعہ جو قابل استعمال ہے لیکن اس کی سپورٹ اور مینٹیننس محدود ہے۔ بتایا گیا ہے کہ فعال کام اب coss ui primitives پر مبنی نئے Particles components پر مرکوز ہے۔ apps/ui/CONTRIBUTING.md میں موجود گائیڈ لائنز کے ذریعے شراکت (contributions) کی دعوت دی گئی ہے، جس میں بگ رپورٹس، فیچرز اور دستاویزات شامل ہیں۔ لائسنسنگ لائسنسنگ ملی جلی ہے۔ پروجیکٹ کے لیے ڈیفالٹ AGPLv3.0 ہے، جبکہ apps/origin/ اور apps/ui/ اپنے اصل MIT لائسنس کے تحت ہیں؛ باقی تمام ڈائریکٹریز AGPLv3 کے زمرے میں آتی ہیں۔ تفصیلات LICENSING.md میں موجود ہیں۔ اعترافات README میں utility-first CSS فریم ورک کے لیے Tailwind CSS، کمپوننٹس کی بنیاد بننے والے accessible primitives کے لیے Base UI، کاپی-پیسٹ کمپوننٹ فلسفے کی ترغیب دینے کے لیے shadcn/ui، اور کمپوننٹ دستاویزات کے پیچھے موجود ڈاکومنٹیشن فریم ورک کے لیے Fumadocs کا شکریہ ادا کیا گیا ہے۔