Skip to content

graphql http blog post #1279

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 1 commit into from
Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 41 additions & 0 deletions src/content/blog/2022-11-07-graphql-http.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
---
title: GraphQL Foundation adopts graphql-http
tags: ["newsletter"]
layout: blog
date: 2022-11-07
byline: GraphQL Foundation
permalink: /blog/2022-11-07-graphql-foundation-graphql-http
---

# GraphQL Foundation adopts graphql-http

GraphQL is most commonly served over HTTP. However despite GraphQL being well
specified, this HTTP transport is not. To correct for this, the GraphQL working
group has been working on the [GraphQL over HTTP](https://graphql.github.io/graphql-over-http/draft/)
specification.

Alongside a specification, we prefer a true implementation to have as a
reference. This ensures the ideas we specify can be implemented well, and that
as edge-cases arise in software we can ensure their solutions are reflected in
the specification as well.

For GraphQL over HTTP, this has nominally been [express-graphql](https://github.com/graphql/express-graphql).
This package makes it easy to create a GraphQL serving endpoint from an express
server. However as the Node community has grown over the years, alternatives to
express have emerged and there is no longer one framework to align to. Also, as
our maintenance bandwidth has focused on other projects, express-graphql has
fallen behind.

Luckily, thanks to the focused efforts of [Denis Badurina](https://github.com/enisdenjo),
we have an alternative in [graphql-http](https://github.com/graphql/graphql-http).
Denis has been part of the committee working on the GraphQL over HTTP
specification, and sought to build a depenency-free compliant GraphQL server
that works with most all existing Node and Deno HTTP frameworks.

The decision was made to adopt the [graphql-http](https://github.com/graphql/graphql-http)
project into the GraphQL Foundation (with Denis continuing as the lead
maintainer), as well as to make it the official reference implementation of
GraphQL over HTTP.

We will be deprecating [express-graphql](https://github.com/graphql/express-graphql)
as part of this change, and recommending those using it migrate to graphql-http.