इस प्रोजेक्ट के बारे में
coss.com/ui (पूर्व में Origin UI) को Cal.com के आधिकारिक डिज़ाइन सिस्टम के रूप में वर्णित किया गया है। यह रिपॉजिटरी एक monorepo है जिसमें कई उत्पाद और एप्लिकेशन शामिल हैं, जो सभी TypeScript में लिखे गए हैं और Turborepo द्वारा प्रबंधित हैं।
रिपॉजिटरी लेआउट
monorepo में इन ऐप्स और पैकेजों की सूची है:
- apps/www/ — मुख्य coss.com वेबसाइट
- apps/ui/ — coss ui घटक लाइब्रेरी और दस्तावेज़ीकरण
- apps/origin/ — लीगेसी Origin UI घटक, जिन्हें अधिग्रहण-पूर्व स्नैपशॉट के रूप में रखा गया है
- packages/ui/ — साझा UI घटक पैकेज
- packages/typescript-config/ — TypeScript कॉन्फ़िगरेशन
- biome.json — लिंटिंग और फॉर्मेटिंग के लिए साझा Biome कॉन्फ़िगरेशन
एनवायरनमेंट वेरिएबल्स
चूंकि कई 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* फ़ाइलों की निगरानी करता है, इसलिए जब वे वेरिएबल्स बदलते हैं तो कैश अमान्य हो जाता है।
डेवलपमेंट वर्कफ़्लो
टूलिंग में स्टैटिक टाइप चेकिंग के लिए TypeScript और लिंटिंग और फॉर्मेटिंग के लिए Biome शामिल है। कमांड bun के साथ चलाए जाते हैं: `bun run build` और `bun run dev` सब कुछ बिल्ड या स्टार्ट करते हैं, जबकि `--filter=www`, `--filter=ui` या `--filter=origin` एक सिंगल ऐप को टारगेट करते हैं।
coss ui क्या प्रदान करता है
coss ui को Base UI के ऊपर निर्मित और Tailwind CSS से स्टाइल किए गए सुलभ, कंपोजेबल React घटकों के संग्रह के रूप में प्रस्तुत किया गया है, जिसे इस तरह डिज़ाइन किया गया है कि डेवलपर्स कोड को कॉपी, पेस्ट और अपना बना सकें। README में कहा गया है कि Base UI के अनस्टाइल्ड प्रिमिटिव्स को एक तैयार-उपयोग डिज़ाइन सिस्टम दिया गया है, और यह वह घटक लाइब्रेरी है जिसे Cal.com धीरे-धीरे अपनाने की योजना बना रहा है। विकास खुले तौर पर जारी है।
Origin UI अधिग्रहण
रिपॉजिटरी में Origin UI घटकों को एक लीगेसी स्नैपशॉट के रूप में शामिल किया गया है: एक Radix-आधारित, shadcn-स्टाइल संग्रह जो उपयोग योग्य बना हुआ है लेकिन सीमित समर्थन और रखरखाव के साथ है। सक्रिय कार्य coss ui प्रिमिटिव्स पर निर्मित नए Particles घटकों पर केंद्रित बताया गया है। apps/ui/CONTRIBUTING.md में दिशा-निर्देशों के माध्यम से योगदान आमंत्रित हैं, जिसमें बग रिपोर्ट, फीचर्स और दस्तावेज़ीकरण शामिल हैं।
लाइसेंसिंग
लाइसेंसिंग मिश्रित है। प्रोजेक्ट के लिए डिफॉल्ट AGPLv3.0 है, जबकि apps/origin/ और apps/ui/ अपने मूल MIT लाइसेंस के तहत बने हुए हैं; अन्य सभी निर्देशिकाएं AGPLv3 के अंतर्गत आती हैं। विवरण LICENSING.md में है।
आभार
README यूटिलिटी-फर्स्ट CSS फ्रेमवर्क के लिए Tailwind CSS, घटकों के अंतर्निहित सुलभ प्रिमिटिव्स के लिए Base UI, कॉपी-पेस्ट घटक दर्शन को प्रेरित करने के लिए shadcn/ui, और घटक दस्तावेज़ों के पीछे के दस्तावेज़ीकरण फ्रेमवर्क के लिए Fumadocs को श्रेय देता है।
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.