https://github.com/graphql/gaps
GraphQL Auxiliary Proposals
https://github.com/graphql/gaps
Last synced: 4 months ago
JSON representation
GraphQL Auxiliary Proposals
- Host: GitHub
- URL: https://github.com/graphql/gaps
- Owner: graphql
- Created: 2026-01-29T19:58:33.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-02-16T18:54:47.000Z (4 months ago)
- Last Synced: 2026-02-17T01:32:01.475Z (4 months ago)
- Language: JavaScript
- Size: 24.4 KB
- Stars: 3
- Watchers: 2
- Forks: 2
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
Awesome Lists containing this project
README
# GraphQL Auxiliary Proposals (GAPs)
This repository provides a public home for GraphQL Auxiliary Proposals (GAPs),
community specifications and auxiliary proposals that address issues outside of
the core GraphQL spec.
This repository is not generally intended for custom scalar specifications,
which already have dedicated homes elsewhere.
## Visit the website
This repository is not designed to be browsed directly; please instead visit the
website which automatically renders each specification via `spec-md` and
includes additional navigational assistance and cross-linking:
https://gaps.graphql.org/
## GAP Numbering
GAPs use number ranges to categorize different types of proposals:
- **1XXX** — Community directive specifications
Other ranges may be added in the future as new categories are identified.
## Repository structure
Each proposal lives in its own `GAP-NNNN` folder and must include:
- `DRAFT.md` — the working document of the proposal/specification
- `README.md` — a brief overview and status, including challenges/drawbacks and
related resources or prior art
- `metadata.yml` — authorship, sponsorship, status, and related metadata
See [CONTRIBUTING.md](./CONTRIBUTING.md) for the full GAP process.