الانتقال إلى المحتوى

التثبيت

ثبّت مكونات React بأسلوب النيوبروتاليزم بأمر واحد من shadcn CLI — دون حزم أو إعدادات. مع الخطوط ورموز Tailwind v4 التي يقوم عليها المظهر المميز.

Neobrutalism.com هو سجل خاص بمشروع «shadcn» CLI. لا توجد حزمة لتثبيتها ولا مزود لتضمين تطبيقك فيه — يقوم الرابط CLI بنسخ شفرة المصدر لكل مكون من موقع neobrutalism.com إلى مشروعك، ومن تلك اللحظة تصبح الشفرة ملكك.

يتكون الإعداد من ثلاث خطوات، ويستغرق حوالي خمس دقائق:

  1. تثبيت مكون — أمر واحد، دون الحاجة إلى أي إعدادات.
  2. أضف الخطوطArchivo Black للعناوين، وSpace Grotesk للنص الأساسي.
  3. أضف عناصر التصميم المميزة — مثل الحواف والظلال ولوحة الألوان التي تجعله ينتمي إلى أسلوب «النيوبروتاليزم».

تثبيت مكون

يتم توفير كل مكون في نسختين، وهما «Base UI»و«Radix UI». ويحدد رابط التثبيت النسخة التي ستحصل عليها:

pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/button.json
npx shadcn@latest add https://neobrutalism.com/r/base/button.json
yarn dlx shadcn@latest add https://neobrutalism.com/r/base/button.json
bunx --bun shadcn@latest add https://neobrutalism.com/r/base/button.json
pnpm dlx shadcn@latest add https://neobrutalism.com/r/radix/button.json
npx shadcn@latest add https://neobrutalism.com/r/radix/button.json
yarn dlx shadcn@latest add https://neobrutalism.com/r/radix/button.json
bunx --bun shadcn@latest add https://neobrutalism.com/r/radix/button.json

هذه هي قصة التثبيت بأكملها. استبدل button بأي مكون — فالنمط هو دائمًا https://neobrutalism.com/r/<base|radix>/<component>.json، وتعرض كل صفحة مكون الأمر الدقيق لكلا الخيارين.

أضف الخطوط

يتم تعيين العناوين باستخدام «Archivo Black»، والنص الأساسي باستخدام «Space Grotesk». باستخدام Next.js، يمكن تحميلهما من «next/font/google»:

app/layout.tsx
import { Archivo_Black, Space_Grotesk } from "next/font/google"
 
const archivoBlack = Archivo_Black({
  subsets: ["latin"],
  weight: "400",
  variable: "--font-head",
  display: "swap",
})
 
const spaceGrotesk = Space_Grotesk({
  subsets: ["latin"],
  variable: "--font-sans",
  display: "swap",
})
 
export default function RootLayout({
  children,
}: {
  children: React.ReactNode
}) {
  return (
    <html lang="en">
      <body className={`${archivoBlack.variable} ${spaceGrotesk.variable}`}>
        {children}
      </body>
    </html>
  )
}

أضف السمة

أضف هذه الرموز إلى ملف «globals.css». فالظلال ذات الإزاحة الحادة و«--radius: 0» هي التي تقوم بمعظم العمل — أما الباقي فيتعلق بلوحة الألوان، وكل ذلك عبارة عن تصميمات بسيطة باستخدام Tailwind v4 يمكنك تغييرها لاحقًا:

globals.css
@import "tailwindcss";
 
@theme inline {
  --font-head: var(--font-head);
  --font-sans: var(--font-sans);
  --radius: var(--radius);
 
  --shadow-xs: 1px 1px 0 0 var(--border);
  --shadow-sm: 2px 2px 0 0 var(--border);
  --shadow: 3px 3px 0 0 var(--border);
  --shadow-md: 4px 4px 0 0 var(--border);
  --shadow-lg: 6px 6px 0 0 var(--border);
  --shadow-xl: 10px 10px 0 1px var(--border);
  --shadow-2xl: 16px 16px 0 1px var(--border);
 
  --color-background: var(--background);
  --color-foreground: var(--foreground);
  --color-card: var(--card);
  --color-card-foreground: var(--card-foreground);
  --color-primary: var(--primary);
  --color-primary-foreground: var(--primary-foreground);
  --color-primary-hover: var(--primary-hover);
  --color-secondary: var(--secondary);
  --color-secondary-foreground: var(--secondary-foreground);
  --color-muted: var(--muted);
  --color-muted-foreground: var(--muted-foreground);
  --color-accent: var(--accent);
  --color-accent-foreground: var(--accent-foreground);
  --color-destructive: var(--destructive);
  --color-destructive-foreground: var(--destructive-foreground);
  --color-border: var(--border);
  --color-input: var(--input);
  --color-ring: var(--ring);
}
 
:root {
  --radius: 0;
  --background: #fff7e8;
  --foreground: #000;
  --card: #fff;
  --card-foreground: #000;
  --primary: #ffdc58;
  --primary-hover: #ffd12e;
  --primary-foreground: #000;
  --secondary: #000;
  --secondary-foreground: #fff;
  --muted: #efe7d6;
  --muted-foreground: #6b6355;
  --accent: #ffe7a3;
  --accent-foreground: #000;
  --destructive: #e63946;
  --destructive-foreground: #fff;
  --border: #000;
  --input: #fff;
  --ring: #000;
}
 
.dark {
  --background: #1a1815;
  --foreground: #f5f0e6;
  --card: #262320;
  --card-foreground: #f5f0e6;
  --primary: #ffdc58;
  --primary-hover: #ffd12e;
  --primary-foreground: #000;
  --secondary: #3a352f;
  --secondary-foreground: #f5f0e6;
  --muted: #2e2a24;
  --muted-foreground: #b3ac9e;
  --accent: #38342b;
  --accent-foreground: #f5f0e6;
  --destructive: #ff6b6b;
  --destructive-foreground: #1a1815;
  --border: #000;
  --input: #262320;
  --ring: #ffdc58;
}

هل تبدأ مشروعًا جديدًا؟

تقدم أدلة إطار العمل شرحاً تفصيلياً لكل شيء بدءاً من الأمر الأول:

  • Next.jscreate-next-app، التهيئة، الخطوط، السمة، المكون الأول.
  • Vite — Tailwind، الأسماء المستعارة للمسارات، التهيئة، المكون الأول.

معاينة قبل التثبيت

افحص شفرة المصدر لأي مكون من خلال المحطة الطرفية:

pnpm dlx shadcn@latest view https://neobrutalism.com/r/base/button.json
npx shadcn@latest view https://neobrutalism.com/r/base/button.json
yarn dlx shadcn@latest view https://neobrutalism.com/r/base/button.json
bunx --bun shadcn@latest view https://neobrutalism.com/r/base/button.json

مساحات أسماء السجل (اختياري)

عناوين URL الكاملة هي كل ما تحتاجه دائمًا. ولكن إذا كنت تقوم بإعداد خادم MCP — الذي يقوم بحل مكونات النظام عبر سجلات مسماة — أو إذا كنت ترغب في استخدام الأوامر search و list الخاصة بـ CLI، فقم بتعيين اسم مستعار للسجل في ملف components.json الخاص بك:

components.json
{
  "registries": {
    "@neobrutalism": "https://neobrutalism.com/r/radix/{name}.json",
    "@neobrutalism-base": "https://neobrutalism.com/r/base/{name}.json"
  }
}

بعد تفعيل الاسم المستعار، يمكن لـ CLI استكشاف السجل بأكمله:

pnpm dlx shadcn@latest search @neobrutalism
npx shadcn@latest search @neobrutalism
yarn dlx shadcn@latest search @neobrutalism
bunx --bun shadcn@latest search @neobrutalism
pnpm dlx shadcn@latest list @neobrutalism
npx shadcn@latest list @neobrutalism
yarn dlx shadcn@latest list @neobrutalism
bunx --bun shadcn@latest list @neobrutalism

مستودع واحد

قم بتوجيه CLI إلى مساحة العمل الصحيحة باستخدام الرابطين -c / --cwd:

pnpm dlx shadcn@latest init -c ./apps/web
npx shadcn@latest init -c ./apps/web
yarn dlx shadcn@latest init -c ./apps/web
bunx --bun shadcn@latest init -c ./apps/web
pnpm dlx shadcn@latest add https://neobrutalism.com/r/base/button.json -c ./apps/web
npx shadcn@latest add https://neobrutalism.com/r/base/button.json -c ./apps/web
yarn dlx shadcn@latest add https://neobrutalism.com/r/base/button.json -c ./apps/web
bunx --bun shadcn@latest add https://neobrutalism.com/r/base/button.json -c ./apps/web

هل تحتاج إلى مساعدة؟

هل تواجه مشكلة ما؟ قناة Discord نشطة — تعال وقل مرحباً.