Lighthouseの未使用CSS警告をルート別分割で解消した記録
全ページで同一のCSSファイルを読み込む構造をやめ、ルート別に3ファイルへ分割してLighthouseの未使用CSS警告を解消した。
① やったこと
Before: 全ページで単一のlayer2.css(40.92 kB)を読み込んでいた。記事詳細ページには、記事一覧専用のフィルタ・カード・ページネーションのスタイルまで含まれており、Lighthouseで「使用していないCSS: 22 KiB」の警告が出ていた。
// app/entry.client.tsx(変更前)
import "~/styles/globals.css";
import "~/styles/blog/layer2.css"; // 全ページで同一ファイルを読み込むAfter: コンポーネントの使用ページを分析し、common.css(全ページ共通)・posts.css(一覧専用)・post-detail.css(詳細専用)の3ファイルに分割した。各ルートファイルで必要なものだけをimportする。
// app/entry.client.tsx(変更後)
import "~/styles/globals.css";
import "~/styles/blog/common.css"; // 全ページ共通のみ
// app/routes/blog._index.tsx
import "~/styles/blog/posts.css"; // 一覧ページ専用
// app/routes/blog.$slug.tsx
import "~/styles/blog/post-detail.css"; // 詳細ページ専用CSS Cascadeの順序は、既存のLayer構造(Layer 1〜5)を壊さないよう、各ルートファイルのimport順を維持したまま分割した。
② 設計判断
- 【優先した価値】: 各ルートが本当に必要とするCSSだけを配信する、責務に応じた分割構造
- 【犠牲にした価値】: 単一ファイルで完結していたときの開発の単純さ。ファイルが3つに増えたことで、Cascade順序を壊さないよう import 順を意識し続ける必要が生まれた
③ 技術的負債
- 【解消した負債】: 記事詳細ページが一覧専用スタイルまで読み込んでいた過剰配信。実測: 40.92 kB → 33.02 kB(-19.3%)
- 【新たに生まれた負債】: 3ファイルに分割したことで、Cascadeの順序を各ルートファイルのimport順で人力管理する必要が生まれた。ファイル追加・削除のたびに順序が崩れると、スタイルが意図せず上書きされるリスクが残る
④ 経営翻訳
全支店に同一の分厚い総合マニュアルを配布しており、専門窓口(記事詳細ページ)にも本部(全体)や別窓口(一覧ページ)向けの章がそのまま含まれていた状態を、窓口ごとに必要な章だけを抜き出した薄いマニュアルへ差し替えた。
実際にはマニュアルの分量が19.3%減り、40.92 kBから33.02 kBになった。専門外の章を配布物から外したことが効いた。
これはLighthouseモバイル全カテゴリ100点を達成した後、「さらに削れるはずだ」という追加最適化として着手したものだが、同じ「分割すれば削減できる」という発想をJavaScriptに適用したところ、Remix/Viteの共有バンドル戦略という壁にぶつかることになる。
全支店に同一の分厚い総合マニュアルを配布しており、専門窓口には本部や別窓口向けの章までそのまま含まれていた。 窓口ごとに必要な章だけを抜き出したマニュアルへ差し替えることにした。
専門窓口に配布するマニュアルの分量: 40.92 kB