このプロジェクトについて

Better Designは、AIコーディングエージェントに構造化されたデザインコンテキストを提供することを目的とした、オープンソースのデザインMCPサーバーおよびshadcn/uiレジストリです。Claude Code、Cursor、VS Code/GitHub Copilot、Claude Desktop、claude.aiを含む、MCP互換のエージェントおよびエディタで動作します。このプロジェクトは、デザインシステムレジストリ、UI原則、アイコンガイダンス、アクセシビリティチェック、および視覚的デザインレビュールールを組み合わせています。 システムは2つのレイヤーで構成されています。「Design Intelligence」レイヤーはUI作業中に常にアクティブであり、エージェントがインターフェースを構築する際に、関連するプロダクトデザイン原則やレビュールールをロードできます。「Scaffold」レイヤーはオンデマンドで動作し、新しいUI作業をデザインシステムに適合させます。ユーザーが「use better-design」と指示すると、MCPが適切なシステムを解決します。READMEには、resolve-design-system、get-design-system-docs、get-ui-principle、get-review-rules、resolve-icon-library、search-iconsといったMCPツールが記載されています。これらは、セマンティックなデザインシステムの照合、トークンとコンポーネントコードのロード、階層・間隔・タイポグラフィ・奥行き・モーション・フォームに関する重点的なガイダンス、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トークンレイヤーとコンポーネントの上書き設定が含まれています。コンポーネントは、レジストリURLを使用してshadcn CLI経由でshadcn/uiプロジェクトにインストールでき、例えばLinearのボタンなどを導入可能です。 セットアップはローカルまたはリモートで可能です。READMEでは、npx skills add marvkr/better-design --skill better-designによるエージェントスキルのインストールと、npx better-designの実行について説明されています。インストーラーはコーディングツールを検出し、既存の設定を置き換えることなくMCPを接続します。また、better-design.com/api/mcpにあるホストされたリモートMCPエンドポイントについても記載されており、サイト設定のAPIキーをAuthorizationヘッダーで使用します。READMEによると、ローカルセットアップではアカウントは不要であり、リモートMCP用のClaude Desktop設定例が提供されています。 リポジトリ構成には、テーマごとのshadcn/ui上書き用コンポーネント、レジストリJSONエントリ、ビルドおよびシードスクリプト、インストール可能なスキル、およびその他のエージェントスキルが含まれています。貢献ガイドラインでは、新しいデザインシステムの追加にはコンポーネントのTSX上書き、対応するレジストリエントリ、およびシードの実行が必要であるとしています。シャドウレイヤー、フォーカス状態、境界線の太さ、ホバー遷移、コンテキストに応じた半径のバリエーションなどのデザイン上の細かなニュアンスは、CSS変数だけでなくコンポーネントコードに組み込まれることが期待されています。本プロジェクトはMITライセンスの下で提供されています。