Participating in Development
GraphQL is developed in the open, through GitHub and working group meetings that are open for anyone to attend (so long as they are covered under the free membership agreement). In addition, anybody is welcome to view the recordings of our meetings on YouTube
Getting up to speed
All of our work happens in the open. In addition, we record our workgroups’ meetings on YouTube. If you are interested in quickly getting up to speed on what’s happening in a working group, the meeting minutes (notes folder in the relevant repository) and replays are a great place to begin.
Asking questions
The best place to ask a development-related question is in a working group meeting, or by opening a GitHub issue. Please note that if you have an implementation question, you may get a faster answer by asking in one of the channels more geared toward users.
GraphQL projects and implementations
- GraphQL Specification
This is a Working Draft of the Specification for GraphQL, a query language for APIs created by Facebook. The target audience for this specification is not the client developer, but those who have, or are actively interested in, building their own GraphQL implementations and tools. To join in with its development, join the main GraphQL Working Group
- GraphQL.js
The JavaScript reference implementation for GraphQL.
- GraphiQL IDE
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!
- GraphQL Website
The source repository for this very website: GraphQL Documentation, community initiatives and more
- GraphQL over HTTP Specification
HTTP is the most common choice as the client-server protocol when using GraphQL because of its ubiquity. However the GraphQL specification deliberately does not specify the transport layer. This specification is intended to fill this gap by specifying how GraphQL should be served over HTTP.
- graphql-http
Simple, pluggable, zero-dependency, GraphQL over HTTP spec compliant server, client and audit suite.
- GraphQL Composite Schema Spec
Describes how to construct a single unified GraphQL schema, the composite schema, from multiple GraphQL schemas, each termed a source schema.
- GraphQL Scalars Specification
Providing a directory of GraphQL Custom Scalar specifications, contributed by the community. GraphQL Custom Scalar specifications are language agnostic and thus can be used to document and standardize behavior across different languages.
- Dataloader
A generic utility to be used as part of your application's data fetching layer to provide a simplified and consistent API over various remote data sources such as databases or web services via batching and caching.
- SWAPI GraphQL Wrapper
A wrapper around the Star Wars API, or "swapi" (Swah-pee) the world's first quantified and programmatically-accessible data source for all the data from the Star Wars canon universe, converting it into a GraphQL schema.
Project adoption guidelines
The graphql GitHub organization is the home for projects that hold a unique role in the ecosystem: specifications, test suites, reference implementations, documentation sites, etc.
Except for graphql-js as a reference implementation, GraphQL implementations in different languages are encouraged to stay in separate organization. This helps folstering ecosystem diversity.
General guidelines:
- The project should be using an opensource license.
- The project should be actively maintained.
- The project should hold a unique role in the ecosystem.
To request adding a new project, please open an issue is the graphql-wg repository. Project adoption is decided by the TSC.
If you want to get involved in GraphQL, add yourself to the meeting agenda for one of our working groups or implementations, sign the document if you haven’t already, and show up! Or, if you prefer, just open a PR against our projects as this will also initiate the spec membership signature process.
We welcome your participation!