The Guild LogoThe Guild Monogram


Fully-featured, simple to set up, performant and extendable GraphQL JavaScript server

Get Started

Integration with Koa#

Koa is a new web framework designed by the team behind Express, which aims to be a smaller, more expressive, and more robust foundation for web applications and APIs. GraphQL Yoga can be integrated easily as a route to the existing Koa application with a few lines of code. So you can benefit middlewares written for Koa with GraphQL Yoga.


yarn add koa yarn add graphql yarn add @graphql-yoga/node


import Koa from 'koa' import { createServer } from '@graphql-yoga/node' const app = new Koa() const graphQLServer = createServer<Koa.ParameterizedContext>() // Bind GraphQL Yoga to `/graphql` endpoint app.use(async (ctx) => { // Second parameter adds Koa's context into GraphQL Context const response = await graphQLServer.handleIncomingMessage(ctx.req, ctx) // Set status code ctx.status = response.status // Set headers response.headers.forEach((value, key) => { ctx.append(key, value) }) // Converts ReadableStream to a NodeJS Stream ctx.body = response.body }) app.listen(4000, () => { console.log('Running a GraphQL API server at http://localhost:4000') })

You can also check a full example on our GitHub repository here