# graphql-config

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

Latest version **5.1.7** (published 2026-09-15) · MIT license · 0 weekly downloads

## Install

```sh
npm install graphql-config
pnpm add graphql-config
yarn add graphql-config
bun add graphql-config
```

## Health

**Score 65/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 5.1.7 |
| Published | 2026-09-15 |
| First published | 2017-07-20 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Node | >= 16.0.0 |
| Dependencies | 11 |
| Unpacked size | 81 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1198 |
| Author | Kamil Kisiela |
| Maintainers | urigo, dotansimha, kamilkisiela, ardatan, theguild-bot |
| Keywords | graphql, config, relay, apollo |

## Links

- npm: https://www.npmjs.com/package/graphql-config
- Repository: https://github.com/kamilkisiela/graphql-config
- Homepage: https://graphql-config.com
- Issues: https://github.com/kamilkisiela/graphql-config/issues
- npm.io page: https://npm.io/package/graphql-config

## Dependencies (11)

- [jiti](https://npm.io/package/jiti.md) ^2.0.0
- [tslib](https://npm.io/package/tslib.md) ^2.4.0
- [minimatch](https://npm.io/package/minimatch.md) ^10.0.0
- [cosmiconfig](https://npm.io/package/cosmiconfig.md) ^8.1.0
- [@graphql-tools/load](https://npm.io/package/@graphql-tools/load.md) ^8.1.0
- [@graphql-tools/merge](https://npm.io/package/@graphql-tools/merge.md) ^9.0.0
- [@graphql-tools/utils](https://npm.io/package/@graphql-tools/utils.md) ^11.0.0
- [string-env-interpolation](https://npm.io/package/string-env-interpolation.md) ^1.0.1
- [@graphql-tools/url-loader](https://npm.io/package/@graphql-tools/url-loader.md) ^9.0.0
- [@graphql-tools/json-file-loader](https://npm.io/package/@graphql-tools/json-file-loader.md) ^8.0.0
- [@graphql-tools/graphql-file-loader](https://npm.io/package/@graphql-tools/graphql-file-loader.md) ^8.0.0

## Alternatives

- [apollo-link-http-common](https://npm.io/package/apollo-link-http-common.md) — 879.0K weekly downloads
- [react-relay](https://npm.io/package/react-relay.md) — 336.8K weekly downloads
- [relay-test-utils](https://npm.io/package/relay-test-utils.md) — 181.6K weekly downloads
- [@vendure/core](https://npm.io/package/@vendure/core.md) — 14.8K weekly downloads
- [@pnpm/deps.graph-sequencer](https://npm.io/package/@pnpm/deps.graph-sequencer.md) — 13.4K weekly downloads

## Recent versions

- 5.1.7 (latest) — 2026-09-15
- 5.1.7-alpha-20260915134924-ea49e75b20357d6aa0669912974f7660bbd197ae (alpha) — 2026-09-15
- 0.0.0-experimental-41adb5d.119 (canary) — 2022-03-26
- 3.0.0-rc.3 (next) — 2020-04-14
- 0.0.0-experimental.0 (experimental) — 2020-03-18
- 3.0.0-alpha.13 (guild) — 2019-10-22
- 5.1.7-alpha-20260915134556-be41c8a3eab9a697bd1905a1d86885c3afb9a963 — 2026-09-15
- 5.1.7-alpha-20260915114942-b191c0939e2a3528547ca427f59c10433315346f — 2026-09-15
- 5.1.7-alpha-20260915113942-caa9f71f895b3bcea2ab30d2879cc4a78ab64a1b — 2026-09-15
- 5.1.6 — 2026-03-06
- 5.1.6-alpha-20260306125431-22d9edbbadf01896b52c90775885bcb3dec3c30f — 2026-03-06
- 5.1.6-alpha-20260305155635-d92537da6681957426215082094f9e960e790514 — 2026-03-05
- 5.1.6-alpha-20260304150721-68bb3ddd27f8611db81e8b8bce30a9cd8200e8df — 2026-03-04
- 5.1.6-alpha-20260227005535-9217bc4fc09cff8489b08a5bbaebc0744a5c6c45 — 2026-02-27
- 5.1.6-alpha-20260227005523-ffa35e3d59cb2fbf5279d9a4342631e36c603c40 — 2026-02-27
- … 440 more at https://npm.io/package/graphql-config/versions

## README

![GraphQL Config](https://i.imgur.com/hw5tXw2.gif 'GraphQL Config')

[![npm version](https://badge.fury.io/js/graphql-config.svg)](https://npmjs.com/package/graphql-config)
[![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier)
[![renovate-app badge](https://img.shields.io/badge/renovate-app-blue.svg)](https://renovateapp.com/)
[![Discord Chat](https://img.shields.io/discord/625400653321076807)](https://discord.gg/xud7bH9)

**GraphQL Config** - one configuration for all your GraphQL tools (supported by most tools, editors & IDEs).
The easiest way to configure your development environment with your GraphQL Schema.

**As a developer**, you gain simplicity and a central place to setup libraries, tools and your IDE extensions.

**As a library author** GraphQL Config makes it easier to maintain the code responsible for handling configuration, loading GraphQL schemas or even files with GraphQL operations and fragments. GraphQL Config provides a set of useful methods and an easy-to-work-with API.

## Example

```yaml
schema: ./schema.json
documents: ./src/components/**/*.jsx
```

## Installation and Usage

Visit our website [**graphql-config.com**](https://graphql-config.com/) to learn more about the GraphQL Config.

## Help & Community

Join our [Discord chat](https://discord.gg/xud7bH9) if you run into issues or have questions. We love talking to you!

## Contributions

Contributions, issues and feature requests are very welcome. If you are using this package and fixed a bug for yourself, please consider submitting a PR!

And if this is your first time contributing to this project, please do read our [Contributor Workflow Guide](https://github.com/the-guild-org/Stack/blob/master/CONTRIBUTING.md) before you get started off.

### Code of Conduct

Help us keep GraphQL Config open and inclusive. Please read and follow our [Code of Conduct](https://github.com/the-guild-org/Stack/blob/master/CODE_OF_CONDUCT.md) as adopted from [Contributor Covenant](https://www.contributor-covenant.org/)

### License

[![GitHub license](https://img.shields.io/badge/license-MIT-lightgrey.svg?maxAge=2592000)](https://raw.githubusercontent.com/apollostack/apollo-ios/master/LICENSE)

MIT

---
_Source: https://npm.io/package/graphql-config · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
