প্রকল্প সম্পর্কে
coss.com/ui (পূর্বে Origin UI) Cal.com-এর অফিসিয়াল ডিজাইন সিস্টেম হিসেবে বর্ণিত। এই রিপোজিটরিটি একটি মনোরেপো যা বেশ কিছু প্রোডাক্ট এবং অ্যাপ্লিকেশন ধারণ করে, যার সবগুলো TypeScript-এ লেখা এবং Turborepo দ্বারা পরিচালিত।
রিপোজিটরি লেআউট
মনোরেপোটিতে এই অ্যাপ এবং প্যাকেজগুলো রয়েছে:
- 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) ভেরিয়েবলগুলো উল্লেখ করা হয়েছে, যেখানে উদাহরণ হিসেবে লোকালহোস্ট পোর্ট ৩০০০, ৪০০০ এবং ৪০০১ দেওয়া হয়েছে। 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.