# graphql/graphql-spec

GraphQL is a query language and execution engine tied to any backend service.

Repository: https://github.com/graphql/graphql-spec
Canonical: https://ross.abutalabs.com/products/graphql-spec
Homepage: https://spec.graphql.org
Language: JavaScript
License: NOASSERTION
License Family: other
Last push: 2026-08-18T20:49:40+00:00

## Health v2 (maintenance only)
Score: 69/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 14, longevity 100
- inputs: {"age_days": 4082, "days_push": 15, "days_rel": 363, "gap_med": null, "n_releases_24m": 1}
- flags: no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 14587, forks 1155 (observed 2026-08-28T04:11:07.305088+00:00)

## What it is
The official GraphQL specification, edited in Markdown and published as versioned releases describing the GraphQL query language, type system, and execution semantics. It serves as the coordination point for implementers building GraphQL servers, clients, and tools.

## Use cases
- implement a GraphQL server from scratch
- check the official semantics of GraphQL queries and validation
- look up how GraphQL type introspection works
- track draft changes to the GraphQL spec
- cite a specific versioned GraphQL specification

## When to choose
- you are building or validating a GraphQL implementation or tool
- you need the authoritative definition of GraphQL syntax and execution semantics
- you want to follow or contribute to GraphQL spec evolution

## When to avoid
- you want a runnable GraphQL library or runtime - use graphql-js or similar
- you need tutorials or getting-started guides rather than normative specification text

## Facets
- artifact type: learning-resource
- maturity: stable
- function: api-framework, documentation, programming-language
- domain: apis, web-development, documentation, developer-tools
- platform: cross-platform
- tags: specification, graphql, query-language, standards, api-specification

## Member repositories
- graphql/graphql-spec (main) score 69

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:07.305088+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:12:28.288253+00:00, confidence not recorded.
  - readme: https://github.com/graphql/graphql-spec (fetched 2026-08-28T04:11:07.305088+00:00, sha 05b3a4ed2c37)
  - homepage: https://spec.graphql.org (fetched 2026-08-29T08:05:57.501981+00:00, sha aff8666af467)
- Data as of 2026-08-30T08:39:29.467469+00:00.