# graphql-hive/graphql-config

One configuration for all your GraphQL tools (supported by most tools, editors & IDEs)

Repository: https://github.com/graphql-hive/graphql-config
Canonical: https://ross.abutalabs.com/products/graphql-config
Homepage: https://the-guild.dev/graphql/config
Language: TypeScript
License: MIT
License Family: permissive
Topics: graphql, devtools, graphqlrc, apollo, relay, graphql-schema, intellij, the-guild
Last push: 2026-03-25T21:54:45+00:00

## Health v2 (maintenance only)
Score: 68/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 74, release rhythm 41, longevity 100
- inputs: {"age_days": 3687, "days_push": 161, "days_rel": 180, "gap_med": 187, "n_releases_24m": 4}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1197, forks 103 (observed 2026-08-28T04:03:57.398329+00:00)

## What it is
GraphQL Config is a library and configuration standard that lets developers define a single .graphqlrc-style config file consumed by most GraphQL tools, editors, and IDEs. It provides an API for library authors to load GraphQL schemas, documents, and extensions from many file formats and sources.

## Use cases
- configure all my graphql tools with one config file
- load a graphql schema from a file, endpoint, or introspection json
- share graphql schema and documents config across editors and ides
- add graphql config support to my own library or cli
- manage multiple graphql projects in a monorepo
- point eslint or codegen at my graphql schema and operations

## When to choose
- you use multiple GraphQL tools (ESLint, Codegen, Inspector, IDE extensions) and want one shared config
- you are a library author who needs to load GraphQL schemas and documents with a standard API
- you work in a monorepo with several GraphQL projects needing per-project configuration

## When to avoid
- your project uses only a single GraphQL tool with its own simpler config
- you need a GraphQL server, client, or runtime - this is configuration only, not execution

## Facets
- artifact type: library
- maturity: stable
- function: configuration-management, developer-tools, graphql, sdk
- domain: developer-tools, web-development, apis
- platform: cross-platform, cli
- tags: graphql-config, graphqlrc, ide-integration, schema-loading, the-guild, typescript, graphql, nodejs

## Member repositories
- graphql-hive/graphql-config (main) score 68

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:57.398329+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:21:27.267263+00:00, confidence not recorded.
  - readme: https://github.com/graphql-hive/graphql-config (fetched 2026-08-28T04:03:57.398329+00:00, sha a8eb75520e57)
  - homepage: https://the-guild.dev/graphql/config (fetched 2026-08-29T12:28:50.666679+00:00, sha 69f6640b2284)
  - site_page: https://the-guild.dev/graphql/config/docs/library/extensions (fetched 2026-08-29T12:28:50.689238+00:00, sha 15031f090eba)
  - site_page: https://the-guild.dev/graphql/config/docs (fetched 2026-08-29T12:28:50.675906+00:00, sha bc1ec9d9fa97)
  - site_page: https://the-guild.dev/about-us (fetched 2026-08-29T12:28:50.678359+00:00, sha 4c4f11519fb9)
  - site_page: https://the-guild.dev/graphql/config/docs/installation (fetched 2026-08-29T12:28:50.680692+00:00, sha 74afab20d025)
  - site_page: https://the-guild.dev/graphql/config/docs/user/usage (fetched 2026-08-29T12:28:50.682692+00:00, sha db0438ebe1af)
  - site_page: https://the-guild.dev/graphql/config/docs/user/schema (fetched 2026-08-29T12:28:50.684516+00:00, sha be9c0b04f228)
  - site_page: https://the-guild.dev/graphql/config/docs/user/documents (fetched 2026-08-29T12:28:50.686224+00:00, sha 0e2a3dd903fe)
  - site_page: https://the-guild.dev/graphql/config/docs/library/load-config (fetched 2026-08-29T12:28:50.687764+00:00, sha 21b9f5b77626)
- Data as of 2026-08-30T08:39:29.467469+00:00.