⚙️ Generate & scaffold type-safe resolvers based on your GraphQL Schema in TypeScript, Flow & Reason
Clone or download

README.md

graphqlgen

CircleCI npm version

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

Features

  • 🚀 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

Documentation

You can find the docs for the graphqlgen CLI here.

Motivation

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.

Supported languages:

Get started

Start from scratch

Bootstrap a GraphQL server based with a ready-made graphqlgen setup then start the server:

With npm

npm init graphqlgen my-app
cd my-app
npm start

Note: npm init requires npm version >= 6.2.0

or

With yarn

yarn create graphqlgen my-app
cd my-app
yarn start

Note: yarn create requires yarn version >= 0.25

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

graphqlgen

Add to existing project

Install

You can install the graphqlgen CLI with either of the following commands:

npm install -g graphqlgen

or

yarn global add graphqlgen

Usage

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.

Support

Note: Using graphqlgen in production

While graphqlgen is ready to be used in production, it's still in active development and there might be breaking changes before it hits 1.0. Most changes will just affect the configuration and generated code layout but not the behaviour of the code itself.

Credits

  • 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

Help & Community Slack Status

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

Prisma