CSSをより多く提供することでサイトパフォーマンスを向上させる
Improving site performance by shipping more CSS (github.blog)
要約
GitHubのエンジニアリングチームは、サイトパフォーマンスを向上させるためにCSSの提供方法を最適化しました。具体的には、CSSをより多く、より効率的に配信することで、ページのロード時間を短縮し、ユーザーエクスペリエンスを改善するアプローチを採用しました。この改善は、ウェブサイトのレンダリングパフォーマンスに直接的な影響を与えます。
全文翻訳
CSS Modulesへの移行によるサイトパフォーマンスの向上
Primer Design Systemは、今日のGitHubで目にする多くのエクスペリエンスを支えています。ボタンからバナー、パンくずリストに至るまで、これらの基本的なコンポーネントは、さまざまなシナリオでアクセシブル、柔軟、かつパフォーマンスが高くあることが求められます。
2023年、特定のページにおけるコンポーネント数が爆発的に増加しました。これにより、既存のCSS-in-JSソリューションでいくつかのパフォーマンス関連の課題が発生しました。
- スタイルがクライアント側で初期化されるため、初期ページロードに時間がかかるようになった
- スタイルの収集がクライアントからサーバーサイドレンダリングに移行したことで、サーバーサイドレンダリングのパフォーマンスが低下した
- ページ上のコンポーネント数が増加するにつれて、スタイルの更新が制御不能になった
Primerチームは、根本的な問題に対処する必要があることを認識しました。現在のソリューションで発生していたクライアントおよびサーバーのコストを完全に回避できる代替手段を見つける必要がありました。最も重要なのは、移行中にGitHubの破損を一切引き起こさない方法で動作する代替手段を選択することでした。
CSS (Modules) の導入
Primerチームは、すべての基準を満たすソリューションを見つけました。CSS Modulesです。このフォーマットにより、私たちは最も好きなことの一つ、つまりネイティブCSS機能の記述と使用が可能になり、同時にCSS-in-JSから期待していたコローケーションとカプセル化のいくらかを維持することができました。
CSS Modulesを使用すると、スタイルはコンポーネントのJavaScriptソースの隣にあるCSSファイルで作成されます。また、すべてのクラス名をデフォルトでローカルとして扱うことができ、グローバルセレクタから生じる競合や課題の一部を防ぐことができます。このフォーマットは、クライアントまたはサーバーのランタイム動作の必要性も排除します。代わりに、スタイルはCSSスタイルシートにロールアップされ、ページのHTMLの一部として送信されます。
しかし、このソリューションは、当時使用していたCSS-in-JSソリューションとは根本的に異なっていました。この変更は、Primerのすべてのコンポーネントと、この手法を使用して作成されたGitHubのすべてのコンポーネントの更新を必要としました。幸いなことに、デザインシステムはこのような変更を大規模に配信するための完璧な手段です。
CSS Modulesへの段階的な移行
CSS Modulesへの移行状況は明確でした。Primerチームは、各コンポーネントに更新を提供し、CSS-in-JSからCSS Modulesに移行する必要がありました。同時に、これらのコンポーネントに対して行った更新は、GitHubでの使用を壊すことはできませんでした。最後に、CSS-in-JSに使用していた根本的な技術も、現在それを使用しているGitHubのコンポーネントで引き続き機能する必要がありました。
これらの制約すべてを考慮し、私たちは世界を壊すことなくコンポーネントの更新を安全に配信できる、段階的な移行戦略を決定しました。各コンポーネントについて、私たちの計画は以下の通りでした。
- 既存のスタイルをCSS Modulesに変換する新しいファイルを追加する
- 新旧のスタイルを切り替えるフィーチャーフラグにコンポーネントを追加する
- 既存のビジュアルリグレッションテストを使用して、CSS-in-JSソリューションとCSS Modulesの間でスナップショットが同一であることを確認する
- フィーチャーフラグをチーム、次にGitHubスタッフ、そして最終的にすべてのGitHubユーザーに段階的にロールアウトして、途中で発生する可能性のある問題をすべて検出する
このプロセスは、Primerがこれらの変更をGitHubに継続的に配信するにつれて、早期に問題を検出できる強力なフィードバックループを作成しました。フィーチャーフラグの使用により、この移行を安全に行うことができ、CSS Modulesのパフォーマンス上の利点に関する明確なシグナルを得ることができました。
2024年12月までに、Primerのすべてのコンポーネントがこのプロセスを使用してCSS Modulesに移行されました。全体的にパフォーマンスの向上が見られましたが、特に以下の点で顕著でした。
- ページのサーバーサイドレンダリングにかかる時間が55%短縮
- ページ上のコンポーネントの初期化にかかる時間が25%短縮
Primerでのこの作業による明確なパフォーマンス上の利点から、GitHubの他の部分でも同様のパフォーマンス上の利点が見られるのではないか、また、最終的に会社全体でCSS-in-JSのサポートを廃止できるのはいつになるのか、と考えるようになりました。
GitHubにおけるCSS-in-JSからの脱却
Primerのデザインシステム自体は公式にstyled-componentsから離れましたが、GitHubのコードベースの大部分はそうではありませんでした。sxプロップは長年GitHubの事実上のスタイリング標準であったため、GitHubを洗練された新しい@primer/reactバージョン(styled-componentsに依存しない)に移行する前に、移行が必要な数千ものsxプロップがありました。
では、どのようにしてこの膨大な作業を、信頼性を高めリスクを低減しながら完了させたのでしょうか?その答えは、一度にすべてを行わなかったということです。
元のCSS移行は、私たちが伝えたよりも少しニュアンスがありました。コンポーネントをCSSモジュールに移行し、本番環境でテストするためにフィーチャーフラグを使用し、ゆっくりとロールアウトすることに加えて、@primer/styled-reactという推移的なライブラリで「ラッパー」コンポーネントを作成しました。このパッケージの目的は、新しく移行されたコンポーネントへのsxの使用を可能にすることでした。これにより、このプロップを使用していたGitHub UIコードベースのインスタンスは、@primer/styled-reactを通じて同じコンポーネントをインポートし続けることができ、一方で、そうでないケースでは@primer/reactから直接インポートすることによるパフォーマンス上の利点を享受することができました。
Styled Box Zero
移行プロセスの次のフェーズは以下の通りでした。
- パッケージごとに:
- すべての
sx使用を同等のCSSモジュールファイルに変換します。これにはクロスリファレンス(CSS変数への移行を参照)が含まれます。 @primer/styled-reactのインポートを@primer/reactのインポートに置き換えます。- 事前本番環境でテストします。
- デプロイします。
- すべての
興味深いことに、この大規模な取り組みに着手する準備をしていた頃、styled-componentsのメンテナンスモードが発表され、私たちが正しい方向に進んでいるというさらなる確認となりました。
作業は2025年4月に開始され、移行すべきsxプロップのピークは約7,760個でした。これは2026年5月まで実現しませんでした。当初、社内の優れた開発者の一人であるIan Sandersが、プロップごとの移行を支援するVS Codeプラグインを作成しました。同様のCodemodが社内で開発され、GitHubコードベースのファイル全体を移行するために利用されました。この作業は、多少の手動での監視と慎重な検証を必要としましたが、大部分は自動化されていました。8人のエンジニアのローテーションが6ヶ月かけて6,419個のプロップを移行し、一部のページでは1%から22%のサーバーサイドレンダリング時間パフォーマンスの向上が観察されました。
[画像: Table titled “Server Side Rendering” with a search field and columns for CATALOG_SERVICE, CONTROLLER, and IMPROVEMENT. It lists GitHub services and controllers with improvement percentages ranging from 3.05% to 21.97%, including a highest value of 21.97% for github/code_view / commit.]
GitHubの別の側面では、Copilotの機能は指数関数的に増加していました。AIはより賢く、より有能になっていました。この作業が進行中である間に、CopilotコーディングエージェントとCopilotコードレビューをリリースしました。
2026年4月にこの作業に戻ったとき、状況は異なっていました。2人のエンジニア、執念、そして多くのCopilotコーディングエージェントの助けにより、3週間で895個から0個のsxプロップにまで減らすことができました。
[画像: Area chart titled “Total SX props” showing values declining from about 7,300 in May to near zero by June–July of the following year, with several short-lived spikes. Two highlighted points are labeled 6.87k around August and 5.37k around October.]
テーマの戦い
それは大きな日でした。ついに、私たちと完全なstyled-components削除の間に立ちはだかっていたsx移行が完了しました。長年の懸案事項でした…依存関係をクリーンアップして、別の、よりエキサイティングな作業に移れるはずですよね?違います!
GitHubは7つの異なるテーマをサポートしており、それらはすべてハイコントラストモードのバリエーションを提供しています。すべては、お察しの通り、styled-componentsを通じて有効化されていました。これらの依存関係を削除することを考える前に、テーマを分離する必要がありました。
これは、聞こえるほど大きな問題ではありません。私たちのテーマ変数は、@primer/cssパッケージを通じて常にCSSで定義されており、2025年後半に@primer/reactを移行した際に、非スタイル化されたテーマ設定のためにすでに将来を見越した計画を立てていました。styled-componentsによって有効化されていたJavaScriptの使用法とユーティリティを削除する必要がありました。再び、私たちは作業に取り掛かりました。
もうお馴染みの手順です。移行を実行し、ゆっくりとロールアウトし、すべてをフィーチャーフラグで管理します。2ヶ月後、いくつかのつまずきがありましたが、依存関係の削除に向けてすべてが順調に進みました。念のため、それさえもフィーチャーフラグで管理しました。安全第一です。
終わり良ければすべて良し
2026年6月現在、GitHubは100% CSS Modulesで稼働しています。私たちが設置したセーフガードにより、重要なアーキテクチャ変更を安全にロールアウトし、本番環境でストレステストを行い、エラーを検出し、効率的に方向転換して修正することができました。最終的に、目標を達成し、その過程で大きなパフォーマンス上の利点を実現することができました。
当初はCSS移行のように見えたものは、GitHubがUIを大規模にスタイリング、テーマ設定、配信する方法の段階的な再プラットフォーム化であることが判明しました。最終的に、sx、styled-components、styled-systemをdotcomから削除しただけでなく、GitHubを壊すことなくそれを完了しました。製品のパフォーマンス、ユーザーエクスペリエンス、そして満足度を高めることは、ここGitHubの私たち全員にとって常に最優先事項です。
タグ:
執筆者
[画像: Josh Black]
Josh Blackはテキサス州オースティンを拠点とするソフトウェアエンジニアです。デザインシステム、アクセシブルなエクスペリエンスの作成、チラキレスを食べるのが大好きです。
[画像: Marie Lucca]
Marieはアトランタを拠点とするGitHub Primerのソフトウェアエンジニアです。ピクセルをプッシュしていないときは、おそらく大西洋上のどこかで機内持ち込み手荷物を頭上の棚に押し込んでいるでしょう。
GitHubからのさらに探求
[画像: Docs]
Docs
GitHubをマスターするために必要なすべてが、1か所にまとまっています。
[画像: GitHub]
GitHub
GitHubで次のものを構築しましょう。どこからでも誰でも、あらゆるものを構築できる場所です。
[画像: Customer stories]
カスタマー事例
GitHubで構築している企業やエンジニアリングチームを紹介します。
[画像: GitHub Universe 2026]
GitHub Universe 2026
10月28~29日にサンフランシスコまたはオンラインで開催されるGitHub Universeにご参加ください。これは、人々、エージェント、そして世界のコードを結びつける、私たちのフラッグシップ開発者イベントです。