概要
GraphQL Code Generatorは、GraphQL schemaとquery/mutation/subscription documentを解析し、TypeScript型、client helper、resolver型等をpluginで生成するtoolです。presetとpluginを組み合わせ、frontendとbackendの双方へ出力できます。
特徴と向いている用途
公式資料に基づく紹介・実機未検証 · 内容確認日:
GraphQL schemaとoperation documentから型を生成する
schemaだけでなく実際のqueryやfragmentを解析し、利用operationに対応する型やclient codeを生成できます。
pluginとpresetで出力形式を組み替える
TypeScript、React、Angular、resolver等のplugin/presetを選び、projectごとの生成物を構成できます。
GraphQL schemaとapplication codeの型ずれを減らしたい場合に
schema変更をcode generationへ反映し、frontend queryやbackend resolverの手書き型定義を減らしたいteamに向きます。
出典:[2]
monorepoではplugin resolutionとGraphQL version重複を確認する
CLIはpluginをloadするため、workspaceのhoisting構成によって解決失敗が起きる場合があります。GraphQL packageの複数versionも型互換問題につながるため依存treeを確認してください。
参考にした公式資料
- [1]dotansimha/graphql-code-generator repository(2026-09-21)
- [2]GraphQL Code Generator README(2026-09-21)
- [3]GraphQL Code Generator installation(2026-09-21)
- [4]@graphql-codegen/cli package(2026-09-21)
- [5]GraphQL Code Generator MIT license(2026-09-21)
編集部からの補足
root packageのversion `0.0.0`はprivate monorepo用placeholderで、配布CLI `@graphql-codegen/cli`は7.4.2です。Node.js 16以上を要求します。pluginを動的にloadするため、pnpm/Yarn workspaceではpluginがCLIと同じnode_modules levelから解決できるか確認してください。
3ステップで試す
- 1
GraphQLとCodegen CLIを追加
公式Quick StartどおりGraphQL runtimeとCodegen CLIを追加します。
pnpm add graphql && pnpm add -D @graphql-codegen/cli - 2
対話式configを生成
schema、document、plugin、出力先を質問に答えながら設定します。
pnpm graphql-codegen init - 3
code generationを実行
生成configを使い、schemaとoperationから型・client code等を出力します。
pnpm graphql-codegen
成長
成長の推移 · 直近30日
11,260 Stars
推移データを蓄積中です。
開発アクティビティ
直近90日・週次
- Commit(直近30日)
- 38
- Open PR
- 68
開発アクティビティを蓄積中です。
Built with
カテゴリとタグ
GitHubデータ
関連情報
関連記事を投稿するこのOSSの使い方や活用事例をMarkdownで投稿できます。管理者が承認した後に公開されます。
あわせて探訪
- Hoppscotch80,429 Stars
共通タグ 2件 · 共通カテゴリ 2件 · 同じ言語
REST・GraphQL・WebSocket・MQTTをWeb/Desktop/CLIで扱えるAPI development ecosystem。
TypeScript - Onfido GraphQL Request1 Stars
共通タグ 2件 · 共通カテゴリ 2件 · 同じ言語
Onfidoがforkした軽量GraphQLクライアント。global fetchを前提にし、RequestInit全体を渡せるようupstream版へ変更を加えている。
TypeScript - Apollo Server13,954 Stars
共通タグ 2件 · 共通カテゴリ 1件 · 同じ言語
Node.jsでschemaとresolverからGraphQL APIを構築するserver。standalone実行、Web framework統合、Federationのsubgraph/gatewayに対応する。
TypeScript - AWS Amplify JavaScript9,561 Stars
共通タグ 2件 · 共通カテゴリ 1件 · 同じ言語
Web/React Nativeアプリから認証、API、ストレージなどのクラウド機能を扱うAWS AmplifyのJavaScriptライブラリ。現在の`aws-amplify`は6.21.0。
TypeScript - urql8,977 Stars
共通タグ 2件 · 共通カテゴリ 1件 · 同じ言語
React・Vue・Solid・Svelte等でGraphQL query/mutationを扱うクライアント。exchangeで通信やcacheを段階的に拡張できる。
TypeScript
情報の誤りを報告
掲載内容に誤りや古い情報があればお知らせください。