概要
本シリーズでは、NestJS + esbuild + Vitest を使用した高速開発環境のモノレポテンプレートを解説します。
テンプレートリポジトリ: GitHub - nestjs-esbuild-vitest
こんな方へ
Prisma 7.x 以降の ESModule 標準化により、従来の NestJS ビルド環境が動作しなくなった方向けのテンプレートです。
- CommonJS 環境 で本番ビルドのパス解決が失敗する
- NestJS の SWC ビルド で拡張子付与が必要になり困っている
- tsc や swc 単体 では ESModule 環境に対応できない
これらの問題を esbuild + SWC で解決し、さらにビルド・テストを劇的に高速化します。
特徴
このテンプレートは、以下の特徴を持つモダンな開発環境を提供します。
| 機能 | 説明 |
|---|---|
| esbuild + SWC | NestJS のデコレーターに対応した超高速ビルド |
| Vitest | SWC を使った高速なユニット/E2E テスト |
| Prisma | ESModule 対応の型安全な ORM |
| Turborepo | 高速なビルドシステムとキャッシング |
| pnpm Catalogs | 依存関係のバージョンを一元管理 |
| ESLint Flat Config | 最新の ESLint 設定形式 + アーキテクチャ検証 |
| GitHub Actions CI | 自動テスト・ビルド |
開発体験の改善
従来の tsc + Jest 環境と比較して、ビルドとテストが劇的に高速化されています。
| 項目 | 従来（tsc + Jest） | 現在（esbuild + Vitest） | 改善率 |
|---|---|---|---|
| ビルド | 20〜30 秒 | 200〜500 ミリ秒 | 約 50〜100 倍 |
| テスト起動 | 5〜10 秒 | 500 ミリ秒〜1 秒 | 約 10〜20 倍 |
| ホットリロード | 非対応 | 対応 | - |
この高速化により、開発中のフィードバックループが劇的に短縮されます。
プロジェクト構成
nestjs-esbuild-vitest/
├── apps/
│ └── server/ # NestJS サーバー
├── packages/
│ ├── database/ # Prisma データベース設定
│ ├── eslint-config/ # 共有 ESLint 設定
│ └── typescript-config/ # 共有 TypeScript 設定
├── turbo.json # Turborepo 設定
└── pnpm-workspace.yaml # pnpm ワークスペース設定
セットアップ
# リポジトリをクローン
git clone https://github.com/your-username/nestjs-esbuild-vitest.git
cd nestjs-esbuild-vitest
# 依存関係をインストール
pnpm install
# すべてのチェックを実行
pnpm check-all
コマンド一覧
| コマンド | 説明 |
|---|---|
pnpm build |
すべてのパッケージをビルド |
pnpm start |
開発サーバーを起動 |
pnpm check-all |
lint, format, tsc, test を実行 |
pnpm lint |
ESLint を実行 |
pnpm format |
Prettier でフォーマットチェック |
pnpm tsc |
TypeScript 型チェック |
pnpm test |
テストを実行 |
pnpm test:coverage |
カバレッジ付きテスト |
pnpm clean |
ビルド成果物を削除 |
次のステップ
以降のページでは、各機能について詳しく解説します。
- Prisma ESModule 化の課題 - なぜ従来のビルド方法では対応できないのか
- esbuild + SWC ビルドシステム - 問題の解決策と設定方法
- Vitest + SWC テスト環境 - 高速なテスト環境の構築
- TypeScript / ESLint 設定 - モダンな設定ファイルの解説
- アーキテクチャ設計 - Vertical Slice Architecture と CQRS