التوثيق

١. انسخ مكوّنًا

افتح أي مكوّن، عاينه حيًّا، ثم اضغط «انسخ الـprompt». ما تحصل عليه ليس الكود وحده بل تعليمات مرتّبة يفهمها Cursor وClaude Code وv0: المهمة أولًا، القيود ثانيًا، والمصدر أخيرًا.

الحسابات المجانية تحصل على نسختين يوميًا. التصفّح والمعاينة مجانيان دائمًا.

٢. ثبّت بالـCLI

كل مكوّن هو مستند سجل متوافق مع shadcn، فالأمر الرسمي يركّبه مباشرة دون أي أداة إضافية:

أضف ?demo=1 لجلب ملف الاستخدام مع المكوّن.

٣. اربطه بمحررك

خادم MCP يعطي وكيلك أربع أدوات: بحث بلغة طبيعية، جلب كود مكوّن، أمر تركيب جاهز، وقائمة التصنيفات. الإعداد في صفحة MCP.

٤. نقاط النهاية

كلها عامة ومفتوحة لـCORS:

٥. انشر مكوّنك

معالج النشر من أربع خطوات: الصق كود المكوّن، ثم كود الاستخدام، ثم التفاصيل. المعاينة تتحدّث وأنت تكتب، فترى ما سيراه الزوار قبل أن تنشر. تحتفظ بحقوق التأليف على كل ما تنشره.

متطلبات المكوّن:

• ملف TSX واحد يصدّر مكوّنًا (افتراضي أو مُسمّى)
• كود استخدام يعرضه دون أن يحتاج بيانات خارجية
• أسماء حزم npm التي يعتمد عليها — تُحمَّل تلقائيًا في المعاينة

ابدأ النشر

٦. كيف تعمل المعاينة

لا يوجد bundler على الخادم. كل معاينة مستند مستقل داخل iframe معزول: يحوّل Babel كود TSX، ويستخرج محلّل خاص حزم npm ويحمّلها من esm.sh عبر import-map يضمن نسخة React واحدة، ثم يُنفَّذ الديمو. النتيجة: تكلفة الخادم لا تتأثر بعدد المعاينات.

المكوّنات التي تحتاج بيانات حيّة من خدمة خارجية (مثل بطاقات التغريدات) تُعرض فارغة — هذا متوقّع، لا خلل.