.graphqlrc(YAML and JSON)
The simplest config specifies only
schema which points to the source of GraphQL Schema.
Based on the above example you may think GraphQL Config accepts only single GraphQL files, but it does more than that.
To learn more about possible sources of GraphQL schema read the "Specifying schema" chapter.
Another piece of GraphQL may be operations and fragments. In GraphQL Config we call them
# ... documents: src/components/**/*.graphql
jsx) please read the "Specifying documents" chapter.
When you want to point out files related to the schema (for instance, React components) and make your IDE GraphQL Extension recognize those files, you can
# ... include: src/components/**/*.jsx exclude: src/components/__ignored__/**/*.jsx
documentsare included by default.
To pass information to GraphQL Config's consumers (like IDE extensions, and Node libraries), you can use an
extensions section that is a key-value object.
schema: './schema/*.graphql' extensions: codegen: generates: ./src/types.ts: plugins: - typescript - typescript-resolvers
Now GraphQL Code Generator (opens in a new tab) can consume that data.
GraphQL Config allows you to define multiple projects within the same config file.
Consider, for instance, writing the following configuration:
schema: './schema.graphql' documents: './src/components/**/*.graphql'
This creates a singular, default project. To extend configuration to multiple projects, you can use the following approach:
projects: foo: schema: './packages/foo/schema.graphql' documents: './packages/foo/src/components/**/*.graphql' bar: schema: './packages/bar/schema.graphql'
It's also possible to define many projects where one is the default. You can simply add
default as that project's name:
projects: default: schema: './packages/foo/schema.graphql' documents: './packages/foo/src/components/**/*.graphql' bar: schema: './packages/bar/schema.graphql'