コンポーネントライブラリを現場で運用する

コンポーネントライブラリは、作るより「使われ続けさせる」ほうが難しい。立派な部品集を用意しても、現場が使わなければゼロです。ここでは、ライブラリを机上の飾りにせず、実際の制作で機能させるための運用を扱います。

使うより速い、を目指す

人がライブラリを使うのは、自分で作るより速いときだけです。呼び出しにくい、探しにくい、直しにくい——どれか一つでもあれば、その部品は使われません。導線と検索性を、機能そのものと同じ優先度で設計します。

ドキュメントは部品とセットにする

「いつ使うか」「いつ使わないか」が書かれていない部品は、誤用されます。各コンポーネントに、用途・状態・禁則を短く添える。これだけで、レビューでの往復が大きく減ります。

• 状態を網羅する — 通常・ホバー・無効・エラーまで用意する。
• 実例を置く — 正しい使い方と、避けたい使い方を並べて見せる。
• 変更履歴を残す — 何がいつ変わったかを追えるようにする。

更新は「壊さずに」進める

ライブラリは生き物で、必ず変わります。破壊的な変更を無造作に流すと、依存する制作物が一斉に壊れます。非推奨（deprecated）の猶予期間を設け、移行の道筋を示してから消す。

監査できない部品は、資産ではなく負債である。

トークンの上に立てる

コンポーネントは、デザイントークンを参照する形で作ると、色やテーマの変更が自動で伝わります。部品ごとに値を直書きしないこと。運用を軽くする自動化の考え方はワークフローの自動化にまとめています。