OSS探訪

GraphQL Code Generator — schemaとoperationから型・client codeを自動生成する

スコアの見方

OSS規模スコアはStars・Watchers・Forks・Contributorsを対数圧縮して重み付けした現在の規模指標(上限なし)です。発掘スコアは現在のOSS規模スコアから発掘時点のOSS規模スコアを引いた値、更新ペースは直近30日Commit数、成長モメンタムは直近の観測期間におけるOSS規模スコア差、OSS健全度は取得できた更新状況・Community Health・Releaseの0〜100評価です。

Stars
11,260
主要言語
TypeScript
ライセンス
MIT
リポジトリ最終更新
2026/09/20

概要

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を生成できます。

出典:[2][3]

pluginとpresetで出力形式を組み替える

TypeScript、React、Angular、resolver等のplugin/presetを選び、projectごとの生成物を構成できます。

出典:[2][3]

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を確認してください。

出典:[3][4]

参考にした公式資料

  1. [1]dotansimha/graphql-code-generator repository(2026-09-21)
  2. [2]GraphQL Code Generator README(2026-09-21)
  3. [3]GraphQL Code Generator installation(2026-09-21)
  4. [4]@graphql-codegen/cli package(2026-09-21)
  5. [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. 1

    GraphQLとCodegen CLIを追加

    公式Quick StartどおりGraphQL runtimeとCodegen CLIを追加します。

    pnpm add graphql && pnpm add -D @graphql-codegen/cli
  2. 2

    対話式configを生成

    schema、document、plugin、出力先を質問に答えながら設定します。

    pnpm graphql-codegen init
  3. 3

    code generationを実行

    生成configを使い、schemaとoperationから型・client code等を出力します。

    pnpm graphql-codegen
公式READMEで確認

成長

成長の推移 · 直近30日

11,260 Stars

推移データを蓄積中です。

開発アクティビティ

直近90日・週次

Commit(直近30日)
38
Open PR
68

開発アクティビティを蓄積中です。

Built with

カテゴリとタグ

GitHubデータ

GitHubのデータGitHubの詳細データを見る

GitHub Topics

  • graphql
  • typescript
  • schema
  • code-generator
  • graphql-schema
  • codegen
  • resolvers
  • react
  • angular
  • csharp
  • java
  • android
Stars
11,260
Forks
1,400
Watchers
75
Open Issues
409
Contributors
433
主要言語
TypeScript
ライセンス
MIT
リポジトリ最終更新
2026/09/20

このOSSの使い方や活用事例をMarkdownで投稿できます。管理者が承認した後に公開されます。

情報の誤りを報告

掲載内容に誤りや古い情報があればお知らせください。