GraphiQL & the GraphQL LSP Reference Ecosystem for building browser & IDE tools.
Note: The primary maintainer @acao is on hiatus until December 2020 Looking for the GraphiQL Docs?: This is the root of the monorepo! The full GraphiQL docs are located at
GraphiQL is the reference implementation of this monorepo, GraphQL IDE, an official project under the GraphQL Foundation. The code uses the permissive MIT license.
Whether you want a simple GraphiQL IDE instance for your server, or a more advanced web or desktop GraphQL IDE experience for your framework or plugin, or you want to build an IDE extension or plugin, you've come to the right place!
The purpose of this monorepo is to give the GraphQL Community:
As we re-write for
Breaking Changes & Improvements: several interfaces are being dropped for new ones are arriving for GraphiQL 1.0.0! Read more in this issue
Learn more about GraphiQL in
(This example shows that GraphiQL works with
create-react-appwithout requiring additional configuration)
Provides CodeMirror with a parser mode for GraphQL along with a live linter and typeahead hinter powered by your GraphQL Schema
Provides a command-line interface for running GraphQL Language Service Server for various IDEs.
An almost fully LSP compliant server process backing the GraphQL Language Service.
Utilities to support the GraphQL Language Service.
Many of these packages need to work in multiple environments.
By default, all typescript packages target
graphql-language-service-cliare made for the node runtime, so they target
graphiqlbrowser bundle use the
.browserslistrc, which targets modern browsers to keep bundle size small and keep the language services performant where async/await is used, and especially to avoid the requirement of
rengenerator-runtimeor special babel configuration.
last 2 versions Firefox ESR not dead not IE 11 not ios 10 maintained node versions
To be clear, we do not support Internet Explorer or older versions of evergreen browsers.
To get setup for local development of this monorepo, refer to DEVELOPMENT.md
This is an open source project, and we welcome contributions. Please see CONTRIBUTING.md for details on how to contribute.
The door is open for proposals for the new GraphiQL Plugin API, and other ideas on how to make the rest of the IDE ecosystem more performant, scaleable, interoperable and extensible. Feel free to open a PR to create a document in the
/proposals/directory. Eventually we hope to move these to a repo that serves this purpose.