https://github.com/graphql/golden-path
https://github.com/graphql/golden-path
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/graphql/golden-path
- Owner: graphql
- Created: 2026-01-29T16:30:02.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-04-29T19:40:48.000Z (about 2 months ago)
- Last Synced: 2026-04-29T21:29:59.031Z (about 2 months ago)
- Language: TypeScript
- Homepage: https://goldenpath.graphql.org/
- Size: 2.94 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# GraphQL Golden Path
This repository is a first draft from the **GraphQL Golden Path Initiative**.
The goal is to help authors of GraphQL software (clients, servers, gateways,
tooling, registries, observability platforms) converge on a shared set of
default behaviors, configuration options, and error language that should lead to
the long term success of their users.
This is **not** intended to be guidance for application developers who write
GraphQL queries. The audience is the people who build the tools and frameworks
those developers use.
## Intent
- Identify common problems that users face, especially issues that cause
frustration, disillusionment, or are hard to rectify if not addressed from the
start.
- Identify and specify the practices that libraries/tooling/frameworks should
put in place so that users never meet these problems.
- Document implementation solutions that can realize each practice.
- Define common names for these techniques/solutions and their parameters, and
determine the recommended defaults and configuration parameters.
- Explain why each practice exists, why it is the recommended default, and when
it may be reasonable for a user to opt out.
- Connect practices and solutions to the concrete problems they solve.
- Don't be overly prescriptive, allow space for innovation.
The long-term aim is that GraphQL tooling can provide a consistent, safe, and
predictable “golden path” out of the box, while still allowing experts to opt
out with informed intent.
The Golden Path isn't aiming to maximize upside (e.g. the absolute most
performant or lowest latency or most efficient), instead it is aiming to
minimize downside - if a user does not invest time in studying all GraphQL's
solutions up front, they should still end up with a solution that is "good
enough" 6 months down the road.
## Status
- Work in progress and **not official**.
- Content is incomplete and may be incorrect.
- The current site is a skeleton to enable discussion and feedback.
## Contributing
This repo is intended to enable collaboration across the GraphQL ecosystem. If
you maintain GraphQL tooling or have strong opinions on defaults, please open
issues or pull requests with suggested solutions, problems, and configuration
details.
## Local development
Make sure you have `yarn` installed:
```bash
npm install -g yarn
```
To install the dependencies
```bash
yarn
```
To start the website in development mode:
```bash
yarn start
```
To build for production:
```bash
yarn build
```