ADR– tag –
-
フロントエンド
同じボタンが3種類できる理由 — デザインシステム
一人で作っていても、ページを増やすほど「同じはずのボタン」が微妙に違うものになっていきます。原因はセンスでも手抜きでもなく、毎回その場で色と余白を決め直しているからです。CSS変数でデザイントークンを定義してマジックナンバーを消し、variantをpropsで受けるButtonを1つ作り、使う側が色を指定できないようにするところまで実際にやります。そのうえでStorybookは入れずに1枚のカタログページを自作し、なぜそう作ったのかをADR(設計判断の記録)として docs/adr/0001 に残します。データの持ち方と、外部と繋ぐときの3つの型も同じ「設計を言葉にする」話として扱います。一人でデザインシステムを作り込みすぎないための線引きも書きました。 -
アプリ
作らないものリストを先に書く — 個人開発の題材選び
道具は全部そろったのに手が止まるのは、実力の問題ではなく「何を作るか決めていない」からです。この記事ではコードをほとんど書きません。そのかわり紙とファイルに残します。題材の選び方を3条件に絞り、この連載で作るアプリ hitokoto(読んだ本と、そこから引いた一文を残すアプリ)を決めます。山場は作らないものリストで、作るものリストより長く書き、1つずつ「なぜ今はやらないか」と「あとで足せるか」を書きます。画面を3枚に数え、データを users / books / quotes の3つの箱に分けてER図を紙で描き、何ができたら完成かを文章で定義し、最後に docs/adr/0001-what-to-build.md として全文を残します。見積もりはしません。かわりに順番を決めます。 -
アプリ
他人は5分しか見ない — READMEと技術選定
動くものは完成しました。でも、リポジトリのURLだけを渡された人には、それが何なのかも、触れる場所も、なぜその技術なのかも伝わりません。この記事では hitokoto のREADMEを「1行でなにか / スクリーンショット / 触れる場所 / 使い方 / 技術構成 / 設計判断 / 既知の問題 / これから」の順で全文書きます。山場は技術選定の1行説明と、できていないことを正直に書くところ。動く場所が無いときの代替(GIF)、デモ用アカウントの作り方、本物の鍵を置かないこと、コミット履歴も見られていること、AIを使ったことを隠さずに書く方法、ライセンスを付けないと「使えない」の意味になること、そして9段階を振り返って次に何をするかまで。就職の指南記事ではありません。他人が5分で理解できる形にする話です。
1