دانلود @clerk/ui و نشانی CDN ایرانی

@clerk/ui از مجموعه Clerk هست. Clerk یه سرویس احراز هویت و مدیریت کاربره و کار این بسته، طبق توضیح رسمی خودش، نگه داشتن کامپوننت های رابط کاربری برای SDK های فرانت اند این سرویسه. یعنی اگه توی یه سایت یا اپلیکیشن فرم ورود، ثبت نام یا صفحه حساب کاربری Clerk رو دیدی، نمایش اون ها احتمالا از همچین بسته ای میاد.

مشکلی که حل می کنه آشناست. ساختن صفحه ورود، ثبت نام، بازیابی رمز و مدیریت نشست ها از صفر کار وقت گیر و پر از جزئیات امنیتیه. Clerk این بخش ها رو آماده می ده و جدا کردن لایه رابط کاربری توی یه بسته مستقل احتمالا به این کمک می کنه که SDK های مختلف یه پایه مشترک داشته باشن. وارد ساختار داخلی دقیقش نمی شیم، چون سازنده خودش اون رو بسته داخلی معرفی کرده و جزئیاتش ممکنه بدون اطلاع قبلی عوض بشه.

همین «داخلی بودن» مهم ترین نکته انتخابه. اگه می خوای توی پروژه React یا Next.js ورود کاربر رو راه بندازی، معمولا بهتره سراغ SDK مخصوص همون فریم ورک Clerk بری و این بسته رو مستقیم وارد کار نکنی. اگه روش کد بنویسی، با هر به روزرسانی ممکنه چیزی بشکنه. مستقیم سراغش رفتن وقتی معنی داره که دلیل مشخصی داشته باشی. مثلا داری ریشه یه رفتار توی کامپوننت ها رو بررسی می کنی، یا برای بازسازی یه بیلد به نسخه دقیق یه وابستگی نیاز داری.

یه نکته هم برای سایت های ایرانی. کامپوننت های Clerk برای کار با خود سرویس Clerk ساخته شدن و این سرویس بیرون از ایران میزبانی می شه. پس نصب بسته به تنهایی کافی نیست و دسترسی شبکه به سرویس، شرایط استفاده و موضوع تحریم ها رو باید جدا بررسی کنی. اگه پروژه ات باید با درگاه پیامکی یا سامانه ورود داخلی کار کنه و به سرویس خارجی وابسته نباشه، Clerk شاید انتخاب مناسبی نباشه.

بسته مجوز MIT داره، یعنی استفاده تجاری و ویرایش کدش آزاده. ولی این مجوز فقط مربوط به کد بسته هست، نه شرایط و هزینه سرویس Clerk. نسخه های رسمی و بدون تغییر @clerk/ui توی مخزن داخلی ما هم در دسترسه، برای روزهایی که دسترسی به منابع بین المللی کند یا قطع می شه.

راهنمای استفاده

قبل از هر چیز ببین واقعا به خود این بسته نیاز داری یا نه. توی بیشتر پروژه ها SDK مخصوص فریم ورکت کافیه و معمولا این بسته رو خودش به عنوان وابستگی میاره. اگه می خوای مستقیم ازش استفاده کنی، این قدم ها رو برو:

• اول مشخص کن توی پروژه ات کدوم SDK Clerk رو با کدوم نسخه استفاده می کنی، چون بسته باید با اون هماهنگ باشه.
• اگه با npm کار می کنی، بسته رو به وابستگی های پروژه اضافه کن و نسخه رو قفل کن، که یه به روزرسانی ناخواسته رفتار کامپوننت ها رو عوض نکنه.
• اگه می خوای مستقیم توی صفحه بیاریش، از کد آماده پایین همین صفحه استفاده کن و فایل رو قبل از اسکریپت های وابسته بارگذاری کن.
• کلیدهای Clerk رو توی متغیرهای محیطی نگه دار، نه توی کدی که سمت کاربره و هر کسی می تونه ببینه.
• بعد از راه اندازی، ورود و ثبت نام رو از شبکه ایران تست کن. چون سرویس Clerk بیرونه، ممکنه توی بعضی شرایط کند باشه یا در دسترس نباشه.

اگه چیزی درست نمایش داده نشد، اول ناهماهنگی نسخه ها رو بررسی کن و بعدش کنسول مرورگر رو ببین.