Generate & scaffold type-safe resolvers based on your GraphQL Schema in TypeScript, Flow & Reason

• 🚀 Schema-first: Based on your GraphQL schema (SDL) & model definitions
• 🤝 Type-safe: Strong mapping between your GraphQL schema and resolvers, input arguments and models
• ♻️ Codegen & scaffolding workflows: Minimal resolver boilerplate & automatically generated type definitions
• 😍 Awesome DX: Auto-completion & Intellisense in VSCode, Webstorm, Atom, VIM & other editors
• 💅 Ecosystem compatibility: Supports prettier and graphql-import out of the box

You can find the docs for the graphqlgen CLI here.

Programming in type-safe environments provides a lot of benefits and gives you confidence about your code. graphqlgen leverages the strongly typed GraphQL schema with the goal of making your backend type-safe while reducing the need to write boilerplate through code generation.

• TypeScript
• Flow (coming soon)
• Reason (coming soon)

Bootstrap a GraphQL server based with a ready-made graphqlen setup:

npm init graphqlgen ./my-app

Then start the server:

cd my-app
yarn start

After updating the GraphQL schema in .my-app/src/schema.graphql, execute the graphqlgen CLI to update all resolvers:

graphqlgen

You can install the graphqlgen CLI with the following command:

npm install -g graphqlgen

Once installed, you can invoke the CLI as follows:

graphqlgen

The invocation of the command depends on a configuration file called graphqlgen.yml which must be located in the directory where graphqlgen is invoked. Here is an example:

language: typescript

schema: ./src/schema.graphql
context: ./src/types.ts:Context
models:
  files:
    - ./src/generated/prisma-client/index.ts

output: ./src/generated/graphqlgen.ts

resolver-scaffolding:
  output: ./src/generated/tmp-resolvers/
  layout: file-per-type

Learn more about the configuration in the docs.

• Create a feature request
• Create a bug report

• gqlgen is the Golang equivalent of graphqlgen and served as a source of inspiration
• graphql-code-generator is a similar tool based on templates support both frontend & backend

Join the #graphqlgen channel our Slack community if you run into issues or have questions. We love talking to you!