https://github.com/Shopify/graphql-design-tutorial

https://github.com/Shopify/graphql-design-tutorial

Last synced: 7 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/Shopify/graphql-design-tutorial
• Owner: Shopify
• License: mit
• Created: 2018-09-17T14:41:05.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2024-03-04T15:22:33.000Z (8 months ago)
• Last Synced: 2024-10-22T03:57:19.534Z (13 days ago)
• Size: 343 KB
• Stars: 2,433
• Watchers: 430
• Forks: 193
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.txt
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

• awesome-list - graphql-design-tutorial

README

        
# [Shopify](https://www.shopify.com) GraphQL Design Tutorial

This tutorial was originally created by [Shopify](https://www.shopify.ca/) for internal

purposes. We've created a public version of it since we think it's useful to

anyone creating a GraphQL API.

It's based on lessons learned from creating and evolving production schemas at

Shopify over almost 3 years. The tutorial has evolved and will continue to

change in the future so nothing is set in stone.

We believe these design guidelines work in most cases. They may not all work

for you. Even within the company we still question them and have exceptions

since most rules can't apply 100% of the time. So don't just blindly copy and

implement all of them. Pick and choose which ones make sense for you and your

use cases.

Read the [full tutorial here](TUTORIAL.md). It's also been translated by the community into [a few other languages](lang).

## Contributing

Contributions are welcome; however, this tutorial reflects rules specific to Shopify and

any substantial changes to those will primarily happen internally and not through external contributions.

Corrections and additional translations are welcome in the [`lang` folder](lang). 

## Code of Conduct

Anyone who wishes to contribute through code or issues, take a look at the

[CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md).

## License

MIT, see [LICENSE](LICENSE.txt) for details.