منصوبے کے بارے میں

Better Design ایک اوپن سورس ڈیزائن MCP سرور اور shadcn/ui رجسٹری ہے جس کا مقصد AI کوڈنگ ایجنٹس کو منظم ڈیزائن سیاق و سباق (context) فراہم کرنا ہے۔ یہ MCP کے ساتھ ہم آہنگ ایجنٹس اور ایڈیٹرز کے ساتھ کام کرتا ہے، جن میں Claude Code، Cursor، VS Code/GitHub Copilot، Claude Desktop، اور claude.ai شامل ہیں۔ یہ پروجیکٹ ڈیزائن سسٹم رجسٹری، UI اصولوں، آئیکن رہنمائی، ایکسیسبیلٹی چیکس، اور بصری ڈیزائن ریویو رولز کا مجموعہ ہے۔ اس سسٹم کی دو تہیں (layers) ہیں۔ Design Intelligence تہہ UI کام کے دوران ہمیشہ فعال رہتی ہے: جب کوئی ایجنٹ انٹرفیس بناتا ہے، تو وہ متعلقہ پروڈکٹ ڈیزائن اصول اور ریویو رولز لوڈ کر سکتا ہے۔ Scaffold تہہ آن-ڈیمانڈ ہے اور نئے UI کام کو ڈیزائن سسٹم سے میچ کرتی ہے؛ ایک صارف "use better-design" کہہ سکتا ہے اور MCP ایک مناسب سسٹم تلاش کر لیتا ہے۔ README میں MCP ٹولز درج ہیں: resolve-design-system، get-design-system-docs، get-ui-principle، get-review-rules، resolve-icon-library، اور search-icons۔ یہ سیمنٹک ڈیزائن سسٹم میچنگ، ٹوکنز اور کمپوننٹ کوڈ لوڈ کرنے، ہائیرارکی، اسپیسنگ، ٹائپوگرافی، ڈیپتھ، موشن اور فارمز پر توجہ مرکوز رہنمائی، WCAG اور بصری ڈیزائن چیک لسٹس، آئیکن فیملی میچنگ، اور Iconify کے ذریعے آئیکن سرچ کا احاطہ کرتے ہیں۔ رجسٹری میں shadcn/ui کے لیے 31 اوپن سورس ڈیزائن سسٹمز موجود ہیں۔ نامزد تھیمز میں Linear، Linear Quality، Supabase، Vercel، Airbnb، Notion، Stripe، Apple، Figma، Light Marketplace، Precision Light، Minimal Light، Dark Orange، Vibrant Dark، Neutral Monochrome، Cinematic Dark، Editorial Dark، Corporate Fintech، Beam Custom، Beam Lib، Glassmorphic Dark، Inset Dark، Lumen Dark، Metal FX Gold، Metal FX Silver، Metal FX Chromatic، Midnight Glass، Monochrome Industrial، Pillow Light، Tactile Minimal، اور TV Style شامل ہیں۔ ہر ڈیزائن سسٹم میں ایک globals.css ٹوکن لیئر اور کمپوننٹ اوور رائیڈز شامل ہیں۔ کمپوننٹس کو shadcn CLI کے ذریعے رجسٹری URL استعمال کرتے ہوئے shadcn/ui پروجیکٹ میں انسٹال کیا جا سکتا ہے، مثال کے طور پر Linear بٹن۔ سیٹ اپ مقامی (local) یا ریموٹ ہو سکتا ہے۔ README میں npx skills add marvkr/better-design --skill better-design کے ذریعے ایجنٹ اسکل انسٹال کرنے اور npx better-design چلانے کی دستاویزات موجود ہیں؛ انسٹالر کوڈنگ ٹولز کا پتہ لگاتا ہے اور موجودہ کنفیگریشن کو تبدیل کیے بغیر MCP کو منسلک کرتا ہے۔ better-design.com/api/mcp پر ایک ہوسٹڈ ریموٹ MCP اینڈ پوائنٹ بھی موجود ہے، جو Authorization ہیڈر میں سائٹ سیٹنگز سے API کی (key) استعمال کرتا ہے۔ README میں بتایا گیا ہے کہ مقامی سیٹ اپ کے لیے کسی اکاؤنٹ کی ضرورت نہیں ہے اور ریموٹ MCP کے لیے Claude Desktop کنفیگریشن کی مثال فراہم کی گئی ہے۔ ریپوزٹری کے ڈھانچے میں ہر تھیم کے لیے shadcn/ui اوور رائیڈز، رجسٹری JSON انٹریز، بلڈ اور سیڈ اسکرپٹس، انسٹال ایبل اسکلز، اور دیگر ایجنٹ اسکلز شامل ہیں۔ تعاون (contributing) کی رہنمائی کے مطابق نئے ڈیزائن سسٹمز کے لیے کمپوننٹ TSX اوور رائیڈز، متعلقہ رجسٹری انٹریز، اور ایک سیڈ رن کی ضرورت ہوتی ہے۔ ڈیزائن کی باریکیوں جیسے شیڈو لیئرز، فوکس اسٹیٹس، بارڈر کی موٹائی، ہوور ٹرانزیشنز، اور سیاق و سباق کے مطابق ریڈیس کی تبدیلیوں کی توقع کمپوننٹ کوڈ میں کی جاتی ہے، نہ کہ صرف CSS ویری ایبلز میں۔ یہ پروجیکٹ MIT لائسنس کے تحت ہے۔