同じボタンが3種類できる理由 — デザインシステム
一人で作っていても、ページを増やすほど「同じはずのボタン」が微妙に違うものになっていきます。原因はセンスでも手抜きでもなく、毎回その場で色と余白を決め直しているからです。CSS変数でデザイントークンを定義してマジックナンバーを消し、variantをpropsで受けるButtonを1つ作り、使う側が色を指定できないようにするところまで実際にやります。そのうえでStorybookは入れずに1枚のカタログページを自作し、なぜそう作ったのかをADR(設計判断の記録)として docs/adr/0001 に残します。データの持ち方と、外部と繋ぐときの3つの型も同じ「設計を言葉にする」話として扱います。一人でデザインシステムを作り込みすぎないための線引きも書きました。