graphqlgen

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

• About
  • Highlights
  • Motivation
  • Supported languages
• Getting started
  • Try out a project initializer
  • Add to existing project
  • Documentation
• Addendum
  • Community
  • Project Status
  • Prior Art

About

Highlights

• Schema-first Design in SDL to derive ideal types
• Type-safety Resolvers with precise signatures including parent, args and return type
• DX Precise resolver types puts your editor intellisense to work
• Ecosystem Interop codegen suitable for Yoga 1 or Apollo Server and supports prettier and graphql-import out of the box

Motivation

Programming in type-safe environments can contribute toward great confidence in your code's integrity. graphqlgen aims to leverage the GraphQL type system to make your resolvers completely type-safe. This is important because resolvers are the heart of any graphql service and yet the hardest to statically type due to their dynaminism.

Supported languages

• TypeScript
• Flow

Others under discussion:

• reason

Getting started

Try out a project initializer

1. Run initializer

   yarn create graphqlgen my-app # npm init graphqlgen my-app
   cd my-app
   yarn start # npm run start

2. Edit ./my-app/src/schema.graphql to your heart's content.

3. Generate types:

   yarn graphqlgen
   

Add to existing project

yarn add --dev graphqlgen # npm install --save-dev graphqlgen

Then you will have access to the cli (gg or graphqlgen):

yarn -s gg --help # npm run gg --help

Usage: graphqlgen or gg

Options:
  -i, --init     Initialize a graphqlgen.yml file
  -v, --version  Show version number                                   [boolean]
  -h, --help     Show help                                             [boolean]

gg depends on the presence of a graphqlgen.yml config located in the directory where gg is invoked. Here is an example:

language: typescript
schema: ./src/schema.graphql
context: ./src/context.ts:Context
output: ./src/generated/graphqlgen.ts
models:
  files:
    - ./src/generated/prisma-client/index.ts

Documentation

https://oss.prisma.io/graphqlgen

Addendum

Community

Join us at #graphqlgen in our Slack group and if you have more fleshed out ideas, bug reports etc. create a Github issue:

• feature request
• bug report

Project Status

graphqlgen is still in early stage development where breaking changes and tool design are a fluid matter. Feedback is deeply appreciated. You may feel comfortable giving it a try on production systems since there is no runtime aspect and hence quite safe to do so (save for a few optional default resolvers).

Prior Art

• 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