National Public Mania


    1.2.1 • Public • Published


    The easiest way to configure your development environment with your GraphQL schema (supported by most tools, editors & IDEs)

    TLDR: Set an environment variable called GRAPHQL_ENDPOINT to your GraphQL endpoint (e.g. https://your.api/graphql) or read ahead for other configuration options.

    Supported by...



    Did we forget a tool/editor? Please add it here.


    You can either configure your GraphQL endpoint via a configuration file or by providing an environment variable.

    Note: This requires Node 5 installed or higher

    Method 1: Configuration via $GRAPHQL_ENDPOINT environment variable

    The easiest way to configure your project is by setting an environment variable called GRAPHQL_ENDPOINT to your GraphQL endpoint.

    export GRAPHQL_ENDPOINT="https://your.api/graphql"

    Method 2: Configuration via .graphqlrc file

    You can either use your actual GraphQL endpoint or if preferred a local schema.json or schema.js file.

    Use GraphQL endpoint

    Note: The headers object is optional and can for example be used to authenticate to your GraphQL endpoint.

      "request": {
        "url": "",
        "headers": {
          "Authorization": "xxxxx"

    Use local schema file (JSON)

      "file": "./schema.json"

    Use local schema file (GraphQL.js)

      "graphql-js": "./schema.js"

    Method 3: Configuration via package.json file

    Use the same configuration options as for the .graphqlrc file but wrap it into an object with the key graphql.

      "dependencies": { ... },
      "graphql": {
        "request": {
          "url": ""

    How it works

    This project aims to be provide a unifying configuration file format to configure your GraphQL schema in your development environment.

    Additional to the format specification, it provides the graphql-config-parser library, which is used by all supported tools and editor plugins. The library reads your provided configuration and passes the actual GraphQL schema along to the tool which called it.

    In case you provided a URL to your GraphQL endpoint, the graphql-config-parser library will run an introspection query against your endpoint in order to fetch your schema.

    graphql-config-parser API Build Status npm version

    import { parse, resolveSchema } from 'graphql-config-parser'
    const config = parse()
      .then((schema) => {
        // use json schema for your tool/plugin
      .catch((err) => {

    Help & Community Slack Status

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


    npm i graphql-config-parser

    DownloadsWeekly Downloads






    Last publish


    • lvarayut
    • romanhotsiy
    • schickling