Skip to main content
デザインシステムは、Replit上で組織が作成するすべてのもの(Webアプリ、モバイルアプリ、スライド、その他のアーティファクト)において、オンブランドのUIを構築するためにAgentが必要とする知識を提供します。標準のReplit pnpmモノレポ内でコンポーネントライブラリ、デザイントークン、ブランドアセット、使用ルールを設定することで、Agentは最初のプロンプトからビジュアル言語を適用します。
デザインシステムはEnterpriseプランのみで利用できます。デザインシステムを設定・管理できるのは組織管理者のみです。

デザインシステムを設定する理由

デザインシステムがない場合、すべてのビルダーはコンポーネントライブラリ、カラートークン、レイアウト規約をAgentに手動で説明する必要があります。デザインシステムを設定することでこの問題を解決します:
  • ビジュアル標準のエンコード:Agentが汎用的なデフォルトではなく、正確なコンポーネント、色、スペーシングを使用します
  • 一貫性の確保:すべてのアプリが同じデザイン言語に従います
  • オンボーディング時間の短縮:新しいビルダーが即座にオンブランドな結果を生み出します
  • 暗黙知のキャプチャ:チームの頭の中に存在するデザインの決定とコンポーネントの使用パターンをAgentのためにドキュメント化します

必要なもの

  • tarファイルまたはtarファイルセットとしてのフロントエンドコードコンポーネントライブラリ
  • デザインシステムで使用するフォントアセットとアイコン
  • デザインシステムのAIドキュメント(MCP、Agentスキル)

設定できること

デザインシステムの設定は3つの部分で構成されます:
  1. カスタムインストラクションcustom_instruction/instructions.mdファイルは、すべてのプロジェクトに適用される高レベルのルールをAgentに提供します:使用するコンポーネントライブラリ、参照するデザイントークン、従うパターン。Agentは常にこのファイルをコンテキストに持ちます。
  2. スキル.agents/skills/内のスキルは、Agentがオンデマンドで読み込む詳細な参照資料を提供します。コンポーネントAPIドキュメント、テーミングガイド、レイアウトパターンライブラリ、メインのインストラクションファイルには大きすぎるその他の詳細な参照コンテンツに使用します。
  3. デザインとブランドアセット。ロゴ、アイコン、フォント、その他のブランドアセットを専用フォルダー(例:src/assets/brand/)に配置します。Agentとビルダーが壊れやすい相対パスの代わりに@brand/logo.svgのようなクリーンなインポートで参照できるよう、Viteパスエイリアスを設定します。これにより、プロジェクト全体でアセット参照が一貫します。

ステップバイステップガイド

このガイドでは、tarファイルとしてパッケージ化された既存のコンポーネントライブラリを使用してデザインシステムをエンドツーエンドで設定する手順を説明します:
  1. 新しいReplitアプリを作成してtarファイルをアップロードします。
  2. Replit Agentにパッケージをインストールしてすべてのコンポーネントを表示するよう指示します。 Agentはプロジェクトを設定してコンポーネントライブラリをレンダリングします。
  3. 出力を確認します。 すべてのコンポーネントが正しく表示され、期待通りであることを確認します。すべてが確認できたら、デザインシステムスキルの作成に進みます。

デザインシステムスキルの作成

コンポーネントが準備できたら、最後のステップはAgentがすべてのプロジェクトでコンポーネント、トークン、使用パターンを参照できるようにデザインシステムスキルを作成することです。 以下のプロンプト全体をコピーしてAgentに貼り付けます。<your-design-system-name>をデザインシステムの名前に置き換えてください:

AgentにスキルをXX接続する

スキルが作成されたら、custom_instruction/instructions.mdがAgentをスキルに向けていることを確認します:
最後に、Agentが最初からビジュアル標準を理解できるよう、replit.mdにデザインシステム固有のコンテキストを事前に設定します。プロジェクトの概要、優先するコンポーネントライブラリ、主要なデザインの好み(スペーシングスケール、アクセシビリティ要件)、アーキテクチャスタックを含めます。

セットアップの検証

デザインシステムを展開する前に、以下の必須事項を確認します:
  • custom_instruction/instructions.mdがAgentをデザインシステムスキルに向けている
  • .agents/skills/にコンポーネント参照、ガイド、パッケージを含むスキルが含まれている
  • replit.mdにプロジェクトの概要、好み、アーキテクチャが事前設定されている
  • デザイントークンファイルが含まれている(tokens.cssまたは同等のもの)
  • デザインシステムパッケージがpackage.jsonに事前インストールされている
  • 新しいテストアプリを作成してAgentがデザインシステムを正しく使用することを確認する

デザインシステムを組織にピン留めする

デザインシステムの準備ができたら、すべての組織メンバーが使用できるようにピン留めします:
  1. 組織内のデザインシステムアプリに移動します
  2. アプリのアクションメニュー(三点ドットメニュー)を開きます
  3. Agentの入力ボックスにピン留めを選択します
Agentの入力ボックスにピン留めオプションを表示するアプリのアクションメニュー
デザインシステムのピン留めとピン留め解除ができるのは組織管理者(system_adminsロールのメンバー)のみです。
メンバーがピン留めされたデザインシステムを編集できずに表示・使用できるよう、メンバーアクセスを読み取り専用に設定します。 メンバーアクセスが読み取り専用に設定された招待ダイアログ デザインシステムは組織のすべてのメンバーのAgentの入力ボックスの下に選択可能なピルとして表示されます。削除するには、同じメニューを開いてAgentの入力ボックスからピン留め解除を選択します。 Agentの入力ボックスで選択可能なピルとして表示されるデザインシステム

デザインシステムを継続的に維持する

デザインシステムは進化します。常に最新の状態に保ちましょう:
  • デザインシステムが新しい色、スペーシング、タイポグラフィの値をリリースしたらトークンファイルを更新する
  • コンポーネントに新しいプロパティ、バリアント、使用パターンが追加されたらスキルを更新する
  • デザイン原則や標準が変更されたらインストラクションを更新する
  • デザインシステムの新しいリリースが出たらパッケージのバージョンを更新する
  • 新しいアプリを作成してAgentが正しい出力を生成することを確認することで定期的にテストする

デザインシステムとカスタムテンプレートの比較

デザインシステムとカスタムテンプレートは異なる目的で使用されます: 通常のReplit体験全体でビジュアル標準に従ってAgentに構築させたい場合はデザインシステムを使用します。根本的に異なるスタックが必要な場合はカスタムテンプレートを使用します。

関連リソース