デザイントークン– tag –
-
フロントエンド
同じボタンが3種類できる理由 — デザインシステム
一人で作っていても、ページを増やすほど「同じはずのボタン」が微妙に違うものになっていきます。原因はセンスでも手抜きでもなく、毎回その場で色と余白を決め直しているからです。CSS変数でデザイントークンを定義してマジックナンバーを消し、variantをpropsで受けるButtonを1つ作り、使う側が色を指定できないようにするところまで実際にやります。そのうえでStorybookは入れずに1枚のカタログページを自作し、なぜそう作ったのかをADR(設計判断の記録)として docs/adr/0001 に残します。データの持ち方と、外部と繋ぐときの3つの型も同じ「設計を言葉にする」話として扱います。一人でデザインシステムを作り込みすぎないための線引きも書きました。 -
アプリ
「動く」と「使える」の差は4つの状態 — Reactの画面
APIは前回で動いています。ここからは人が触るものを作るので、判断の基準が「正しいか」から「分かるか」に変わります。hitokoto の画面を3枚だけ作り、Vite の server.proxy で開発中のCORSを消し、そのうえで山場として「読み込み中 / 空っぽ / エラー / 正常」の4つの状態を全部書きます。一番忘れるのは空っぽです。初めて開いた人が最初に見る画面がそこだからです。フォームの二重送信を止め、失敗しても入力を消さず、デザイントークンとButtonを作り直さずに使い回します。最後は npm run build して nginx から dist/ を配り、/api をプロキシして「本番の形」で確認します。開発サーバーでしか動かない状態で終わりにしません。
1