🗺️ الخريطة

البداية٣ فصول
فصل ١يعني إيه Registry أصلًا؟#توزيع كود #فهرس #item #عناوين
فصل ٢registry.json — فهرس الـ Registry#فهرس #include #مسارات نسبية #أسماء unique
فصل ٣registry-item.json — كل حقل في الوصفة#أنواع الـ items #dependencies #target #placeholders #envVars
المحتوىفصل واحد
فصل ٤الألوان والـ CSS والخطوط والـ Design Systems#cssVars #@layer #@utility #fonts #style #base
التطبيقفصلين
فصل ٥ابني الـ Registry وقدّمه وجرّبه#build #route handlers #Accept header #list/view/add #نشر
فصل ٦GitHub Repo يبقى Registry#من غير سيرفر #refs #private repos #حدود #مراجعة
التوسع٣ فصول
فصل ٧Namespaces — كذا Registry في مشروع واحد#namespace #URL template #ترتيب الحل #override #versioning #errors
فصل ٨Registry Private بـ Authentication#tokens #السيرفر #team access #error messages #أمان
فصل ٩Dynamic Search للـ Registries الكبيرة#search على السيرفر #pagination #كذا registry #backwards compatible
النشرفصلين
فصل ١٠الـ Registry Directory ومراقبة الـ Health#تسجيل namespace #الشروط #Observing/Healthy/Degraded/Unavailable #السكور #الترتيب
فصل ١١الـ Registry مع الـ AI — الـ MCP والـ Open in v0#MCP server #Claude Code #Cursor #VS Code #Codex #OpenCode #v0
الأدواتفصل واحد
فصل ١٢الـ API البرمجي في shadcn#config #useCache #local vs remote #typed errors #zod schemas #presets
بعدهافصل واحد
الآخرCheat Sheet: shadcn Registry#المشكلة والحل في سطر

الفكرة كلها في سطر واحد: shadcn مش npm package بتعمله install، ده كود بيتنسخ جوه مشروعك. والـ registry هو إنك تعمل نفس الحكاية لكودك إنت. تكتب component أو hook أو ملف config مرة واحدة، وأي مشروع ياخده بـ npx shadcn add.