Turborepo / pnpm workspaces を採用する理由

pnpm workspacesは、Node.jsのパッケージ管理ツールpnpmが持つ機能で、複数のプログラムを一つのリポジトリの中に置き、それぞれの依存関係をまとめて管理する仕組みです。Turborepoは、その上で「どのプログラムから順にビルドやテストを実行するか」を依存関係から自動で判断し、変更のない部分の結果を再利用して処理時間を短縮するツールです。両者を組み合わせた構成は「モノレポ」と呼ばれ、利用者向けの画面、管理画面、API、それらが共有する型定義や部品を、一つの場所で一貫して管理できます。

弊社では、画面とAPIを分けて開発するWebシステムや、利用者向けと管理者向けの複数の画面を持つシステムで、Turborepoとpnpm workspacesによるモノレポ構成を採用しています。最大の理由は、APIがやり取りするデータの型や入力チェックのルール、共通のUI部品を一か所に置き、画面とサーバーの両方から参照できることです。仕様を変更した際に、影響する箇所が同じリポジトリの中で型チェックによって一度に見つかるため、片方だけ更新し忘れる事故を防げます。Turborepoは変更のあった部分だけをビルド・テストするため、GitHub Actionsでの自動検証の時間も抑えられます。複数の開発者が並行して作業する案件でも、環境構築の手順が一つで済み、参加や引き継ぎの負担を減らせる点も採用理由です。

モノレポ構成では、一つのリポジトリに多数の依存関係が集まるため、更新の際は影響範囲を把握しやすい反面、一度に扱う量が増えます。pnpmの依存関係を記録したファイルを管理し、定期的に棚卸しの時期を決めて更新するのが基本です。Turborepoの結果の再利用が効くよう、各プログラムのビルド設定で入力と出力を正しく宣言しておくと、検証時間の増加を防げます。引き継ぎの際は、リポジトリ全体の構成図とプログラム間の依存関係を資料として残しておくと、把握が早くなります。