skill

شادسن

يدير مكونات ومشاريع shadcn — إضافة، بحث، إصلاح، تصحيح، تصميم، وتأليف واجهة المستخدم، بما في ذلك واجهات الدردشة. يوفر سياق المشروع، وثائق المكونات، وأمثلة الاستخدام. ينطبق عند العمل مع shadcn/ui، سجلات المكونات، الإعدادات المسبقة، أكواد --preset، أو أي مشروع يحتوي على ملف components.json. يتم تفعيله أيضا ل "shadcn init"، "create an app with --preset"، "switch to --preset"، ولبناء نظام تصميم أو تطبيق مواصفات DESIGN.md أو مواصفات علامة تجارية على shadcn/ui.

shadcn271,099+ تثبيتموثوق

نبذة

# shadcn/ui

إطار عمل لبناء واجهة المستخدم والمكونات وأنظمة التصميم. تضاف المكونات كشفرة مصدرية إلى مشروع المستخدم عبر CLI.

> **هام:** قم بتشغيل جميع أوامر CLI باستخدام مشغل الحزم الخاص بالمشروع: `npx shadcn@latest`، `pnpm dlx shadcn@latest`، أو `bunx --bun shadcn@latest` — بناء على `packageManager` الخاص بالمشروع. الأمثلة أدناه تستخدم `npx shadcn@latest` ولكن استبدل المشغل الصحيح للمشروع.

## سياق المشروع الحالي

```json !`npx shadcn@latest info --json` ```

يحتوي JSON أعلاه على إعدادات المشروع والمكونات المثبتة. استخدم `npx shadcn@latest docs <component>` للحصول على التوثيق وعناوين URL للأمثلة لأي مكون.

## المبادئ

1. **استخدم المكونات الموجودة أولا.** استخدم `npx shadcn@latest search` للتحقق من السجلات قبل كتابة واجهة مستخدم مخصصة. تحقق من سجلات المجتمع أيضا. 2. **ركب، لا تعد اختراع العجلة.** صفحة الإعدادات = Tabs + Card + عناصر تحكم النموذج. لوحة التحكم = Sidebar + Card + Chart + Table. 3. **استخدم المتغيرات المدمجة قبل الأنماط المخصصة.** `variant="outline"`، `size="sm"`، إلخ. 4. **استخدم الألوان الدلالية.** `bg-primary`، `text-muted-foreground` — لا تستخدم أبدا قيما خاما مثل `bg-blue-500`.

## القواعد الأساسية

هذه القواعد **تطبق دائما**. كل منها يرتبط بملف يحتوي على أزواج من الشفرات غير الصحيحة/الصحيحة.

### الأنماط و Tailwind ← [styling.md](./rules/styling.md)

* **`className` للتخطيط، وليس للأنماط.** لا تقم أبدا بتجاوز ألوان المكونات أو الطباعة. * **لا تستخدم `space-x-*` أو `space-y-*`.** استخدم `flex` مع `gap-*`. للمكدسات العمودية، `flex flex-col gap-*`. * **استخدم `size-*` عندما يكون العرض والارتفاع متساويين.** `size-10` وليس `w-10 h-10`. * **استخدم اختصار `truncate`.** ليس `overflow-hidden text-ellipsis whitespace-nowrap`. * **لا توجد تجاوزات يدوية لألوان `dark:`.** استخدم الرموز الدلالية (`bg-background`، `text-muted-foreground`). * **استخدم `cn()` للفئات الشرطية.** لا تكتب تعبيرات ثلاثية يدوية في قالب حرفي. * **لا توجد `z-index` يدوية على مكونات التراكب.** Dialog، Sheet، Popover، إلخ. تتعامل مع ترتيب التكدس الخاص بها.

### النماذج والمدخلات ← [forms.md](./rules/forms.md)

* **تستخدم النماذج `FieldGroup` + `Field`.** لا تستخدم أبدا `div` خاما مع `space-y-*` أو `grid gap-*` لتخطيط النموذج. * **تستخدم `InputGroup` كل من `InputGroupInput`/`InputGroupTextarea`.** لا تستخدم أبدا `Input`/`Textarea` خاما داخل `InputGroup`. * **تستخدم الأزرار داخل المدخلات `InputGroup` + `InputGroupAddon`.** * **تستخدم مجموعات الخيارات (2-7 خيارات) `ToggleGroup`.** لا تقم بتكرار `Button` بحالة نشطة يدوية. * **`FieldSet` + `FieldLegend` لتجميع مربعات الاختيار/أزرار الراديو ذات الصلة.** لا تستخدم `div` مع عنوان. * **يستخدم التحقق من صحة الحقول `data-invalid` + `aria-invalid`.** `data-invalid` على `Field`، `aria-invalid` على عنصر التحكم. للمعطل: `data-disabled` على `Field`، `disabled` على عنصر التحكم.

### هيكل المكون ← [composition.md](./rules/composition.md)

* **العناصر دائما داخل مجموعتها.** `SelectItem` ← `SelectGroup`. `DropdownMenuItem` ← `DropdownMenuGroup`. `CommandItem` ← `CommandGroup`. * **استخدم `asChild` (radix) أو `render` (base) للمشغلات المخصصة.** تحقق من حقل `base` من `npx shadcn@latest info`. ← [base-vs-radix.md](./rules/base-vs-radix.md) * **تحتاج Dialog، Sheet، و Drawer دائما إلى عنوان.** `DialogTitle`، `SheetTitle`، `DrawerTitle` مطلوبة لإمكانية الوصول. استخدم `className="sr-only"` إذا كانت مخفية بصريا. * **استخدم تركيبة Card الكاملة.** `CardHeader`/`CardTitle`/`CardDescription`/`CardContent`/`CardFooter`. لا تضع كل شيء في `CardContent`. * **لا يحتوي Button على `isPending`/`isLoading`.** ركب مع `Spinner` + `data-icon` + `disabled`. * **يجب أن يكون `TabsTrigger` داخل `TabsList`.** لا تقم أبدا بعرض المشغلات مباشرة في `Tabs`. * **يحتاج `Avatar` دائما إلى `AvatarFallback`.** عندما تفشل الصورة في التحميل.

### استخدم المكونات، وليس الترميز المخصص ← [composition.md](./rules/composition.md)

* **استخدم المكونات الموجودة قبل الترميز المخصص.** تحقق مما إذا كان المكون موجودا قبل كتابة `div` منسق. * **تستخدم Callouts مكون `Alert`.** لا تبن divs منسقة مخصصة. * **تستخدم حالات الفراغ مكون `Empty`.** لا تبن ترميزا مخصصا لحالة الفراغ. * **يتبع Toast قاعدة المشروع.** استخدم `toast` من مكون `toast` لمشاريع Base UI. استخدم `toast()` من `sonner` لمشاريع Radix و React Aria. * **استخدم `Separator`** بدلا من `<hr>` أو `<div className="border-t">`. * **استخدم `Skeleton`** للعناصر النائبة للتحميل. لا توجد divs مخصصة `animate-pulse`. * **استخدم `Badge`** بدلا من span المنسقة المخصصة.

### الأيقونات ← [icons.md](./rules/icons.md)

* **تستخدم الأيقونات في `Button` خاصية `data-icon`.** `data-icon="inline-start"` أو `data-icon="inline-end"` على الأيقونة. * **لا توجد فئات تحديد الحجم على الأيقونات داخل المكونات.** تتعامل المكونات مع تحديد حجم الأيقونات عبر CSS. لا تستخدم `size-4` أو `w-4 h-4`. * **مرر الأيقونات ككائنات، وليس كمفاتيح نصية.** `icon={CheckIcon}`، وليس بحثا نصيا.

### الدردشة والمراسلة ← [chat.md](./rules/chat.md)

* **تركب واجهة مستخدم الدردشة من العناصر الأولية للدردشة.** تستخدم المحادثات `MessageScroller`، وتستخدم الصفوف `Message`، وتستخدم الأسطح `Bubble`. لا تستخدم أبدا `div` فقاعية يدوية أو حاوية تمرير خام. * **يمتلك `MessageScroller` سلوك التمرير.**

التثبيت

شغل هذا الأمر

npx skills add shadcn/ui

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `npx skills add shadcn/ui`، أو استنسخ المستودع وانسخ مجلد `skills/shadcn` إلى دليل مهارات Claude الخاص بك.

عرض المصدر

أسئلة شائعة

ما هي مهارة شادسن؟

يدير مكونات ومشاريع shadcn — إضافة، بحث، إصلاح، تصحيح، تصميم، وتأليف واجهة المستخدم، بما في ذلك واجهات الدردشة. يوفر سياق المشروع، وثائق المكونات، وأمثلة الاستخدام. ينطبق عند العمل مع shadcn/ui، سجلات المكونات، الإعدادات المسبقة، أكواد --preset، أو أي مشروع يحتوي على ملف components.json. يتم تفعيله أيضا ل "shadcn init"، "create an app with --preset"، "switch to --preset"، ولبناء نظام تصميم أو تطبيق مواصفات DESIGN.md…

كيف أثبت شادسن؟

شغل هذا الأمر في الطرفية:

npx skills add shadcn/ui
مع أي أدوات ذكاء اصطناعي تعمل شادسن؟

تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.

من طور شادسن؟

طورها shadcn.

هل شادسن مجانية؟

نعم، يمكنك استخدامها مجانا.

أصول ذات صلة

مختارات أخرى في التسويق والإعلان.

كل بدائل شادسن ←
skillclaude_appclaude_codeclaude_api
npx skills add genmedia-labs/skills
توليد الصور بالذكاء الاصطناعي
أنشئ وعدل الصور على RunComfy عبر واجهة سطر الأوامر `runcomfy` — وهو موجه ذكي عبر كتالوج نماذج الصور الكامل: FLUX 2 (Klein 9B/4B, Pro, Dev, Flash, Turb…716,844+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
هايبر فريمز الإبداعية
توجيه إبداعي غير متحرك لفيديوهات HyperFrames. يستخدم لمواصفات التصميم (frame.md / design.md)، لوحات الألوان، الطباعة، السرد، تخطيط الإيقاع، المرئيات ا…690,064+
skillclaude_appclaude_codeclaude_api
npx skills add flowkit-labs/skills
أتمتة Reddit
ابحث في سلاسل Reddit حيث يطلب الأشخاص بصدق ما تقدمه، ثم صغ ردودا قصيرة ومفيدة حقا — مع الكشف عن انتمائك بصدق وذكر اسم منتجك فقط عندما يجيب حقا على الس…686,503+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
فيديو عام
تأليف أو تعديل تركيبة HyperFrames مخصصة عندما لا يتناسب سير عمل متخصص، أو عندما يحدد BRIEF.md التدفق: companion. استخدمها للقطع الأطول أو متعددة المشا…629,562+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
إطارات فائقة، إطارات مفتاحية
يستخدم عندما تحتاج تركيبة HyperFrames إلى تكبير/تصغير (punch-in, punch-out, zoom)، إعادة تأطير (reframe)، معالجة Ken Burns، حركة كاميرا، تسليم بصري مت…574,917+
skillclaude_appclaude_codeclaude_api
npx skills add 101-skills/superpowers
توليد الفيديو بالذكاء الاصطناعي
أنشئ مقاطع فيديو بالذكاء الاصطناعي باستخدام Google Veo و Seedance 2.0 و HappyHorse و Wan و Grok وأكثر من 40 نموذجا عبر inference.sh CLI. النماذج: Veo…553,709+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في التسويق والإعلان