# graphql-hive/graphql-yoga

🧘 Rewrite of a fully-featured GraphQL Server with focus on easy setup, performance & great developer experience.  The core of Yoga implements WHATWG Fetch API and can run/deploy on any JS environment.

Repository: https://github.com/graphql-hive/graphql-yoga
Canonical: https://ross.abutalabs.com/products/graphql-yoga
Homepage: https://the-guild.dev/graphql/yoga-server
Language: TypeScript
License: MIT
License Family: permissive
Topics: graphql, graphql-server, javascript, typescript, w3c, fetch, whatwg, nodejs, bun, deno, the-guild
Last push: 2026-08-20T13:52:44+00:00

## Health v2 (maintenance only)
Score: 98/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 98, release rhythm 98, longevity 100
- inputs: {"age_days": 3213, "days_push": 13, "days_rel": 14, "gap_med": 6, "n_releases_24m": 50}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 8527, forks 596 (observed 2026-08-28T04:10:23.345900+00:00)

## What it is
GraphQL Yoga is a batteries-included, spec-compliant GraphQL over HTTP server library for JavaScript/TypeScript, built on Envelop and GraphQL Tools. Its core uses the WHATWG Fetch API so it runs in any JS environment, including Node.js, Deno, Bun, and serverless platforms like AWS Lambda and Cloudflare Workers.

## Use cases
- set up a GraphQL server in Node.js with minimal boilerplate
- deploy a GraphQL API to Cloudflare Workers or AWS Lambda
- add GraphQL subscriptions over websockets to my API
- serve a GraphQL API with built-in GraphiQL IDE for development
- migrate an existing Apollo Server to a lighter alternative
- implement Apollo Federation subgraphs
- add file uploads and error masking to a GraphQL endpoint
- run the same GraphQL server across Node, Deno, and Bun

## When to choose
- you want a batteries-included GraphQL server with GraphiQL, subscriptions, file uploads, and health checks out of the box
- you need to deploy GraphQL to serverless or edge runtimes via the Fetch API
- you want a self-hosted, open-source alternative to Apollo Server
- you need Apollo Federation support or persisted operations and response caching

## When to avoid
- you need a REST API rather than GraphQL
- you want a fully managed hosted GraphQL backend with no server to run
- your stack is not JavaScript/TypeScript
- you need deep customization that conflicts with Yoga's Envelop plugin model

## Facets
- artifact type: library
- maturity: stable
- function: graphql, http-server, middleware, websocket, file-upload, caching, rate-limiting, auth, plugin-system
- domain: web-development, backend, apis, developer-tools
- platform: bun, serverless, cloud, cross-platform
- tags: graphql-server, envelop, apollo-federation, graphiql, subscriptions, serverless, the-guild, fetch-api, nodejs, deno, web-server, typescript

## Member repositories
- graphql-hive/graphql-yoga (main) score 98

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:23.345900+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:26:40.162236+00:00, confidence not recorded.
  - readme: https://github.com/graphql-hive/graphql-yoga (fetched 2026-08-28T04:10:23.345900+00:00, sha 2d85643fba12)
  - homepage: https://the-guild.dev/graphql/yoga-server (fetched 2026-08-29T08:27:05.492712+00:00, sha ecec473c9c41)
  - site_page: https://the-guild.dev/graphql/yoga-server/docs/features/error-masking (fetched 2026-08-29T08:27:05.514405+00:00, sha 4930ec14351d)
  - site_page: https://the-guild.dev/graphql/yoga-server/docs (fetched 2026-08-29T08:27:05.501646+00:00, sha d59b8436ab25)
  - site_page: https://the-guild.dev/graphql/yoga-server/docs/features/schema (fetched 2026-08-29T08:27:05.508506+00:00, sha 9592e0221055)
  - site_page: https://the-guild.dev/graphql/yoga-server/docs/features/graphiql (fetched 2026-08-29T08:27:05.510278+00:00, sha 1ff9d33f031d)
  - site_page: https://the-guild.dev/graphql/yoga-server/docs/features/context (fetched 2026-08-29T08:27:05.512203+00:00, sha d693ac3444cc)
  - site_page: https://the-guild.dev/graphql/yoga-server/v4 (fetched 2026-08-29T08:27:05.503375+00:00, sha e4ef106bef56)
  - site_page: https://the-guild.dev/graphql/yoga-server/v3 (fetched 2026-08-29T08:27:05.505077+00:00, sha 31ac7086f886)
  - site_page: https://the-guild.dev/graphql/yoga-server/v2 (fetched 2026-08-29T08:27:05.506790+00:00, sha 896d7ba11a7a)
- Data as of 2026-08-30T08:39:29.467469+00:00.