awesome-graphql

Awesome list of GraphQL & Relay

If you want to contribute to this list (please do), send me a pull request.

Table of Contents

• Specification
• Foundation
• Community
• Libraries
  • Javascript
  • Ruby
  • PHP
  • Python
  • Java
  • C/C++
  • Go
  • Scala
  • .NET
  • Elixir
  • Haskell
  • SQL
  • Lua
  • Elm
  • Clojure
  • Swift
  • OCaml
• Tools
• Services
• Databases
• Examples
  • Javascript
  • Typescript
  • Ruby
  • Go
  • Scala
  • Python
  • Elixir
  • Java
• Videos
• Blogs
• Posts
• Workshoppers

Specification

• facebook/graphql - Working Draft of the Specification for GraphQL created by Facebook.

Foundation

• GraphQL Foundation - GraphQL Foundation under the Linux Foundation

Community

• Slack - Share and help people on the chat. Get your invite here
• Facebook - Group for discussions, articles and knowledge sharing
• Twitter - Use the hashtag #graphql
• StackOverflow - Questions and answers. Use the tag graphql
• GraphQL APIs - A collective list of public GraphQL APIs
• GraphQL World - The fastest growing community of GraphQL developers

GraphQL Meetups

• Bangalore
• Berlin
• Buenos Aires
• Dallas-Fort Worth
• London
• Manchester
• Melbourne
• Munich
• New York City
• San Francisco
• Seattle
• Sydney
• Tel Aviv
• Toronto

Libraries

JavaScript Libraries

Clients

• relay - Relay is a JavaScript framework for building data-driven React applications.
• Apollo Client - A well-documented GraphQL client. Has React and Angular bindings.
• aws-amplify - A client library developed by Amazon for caching, analytics and more that includes a way to fetch GraphQL queries.
• graphql-request - A minimal GraphQL client for Node and browsers.
• FetchQL - A simple GraphQL query client using Fetch.
• urql - A simple caching GraphQL client for React.
• micro-graphql-react - A lightweight utility for adding GraphQL to React. components. Includes simple caching and uses GET requests that could additionally be cached through a service-worker.
• Lokka - Simple JavaScript client for GraphQL, which you can use anywhere.
• react-reach - A library to communicate with Graphql through Redux.

Miscellaneous

• GraphQL.js - A reference implementation of GraphQL for JavaScript.
• express-graphql - GraphQL Express Middleware.
• koa-graphql - GraphQL Koa Middleware.
• hapi-graphql - Create a GraphQL HTTP server with Hapi.
• hapi-plugin-graphiql - HAPI plugin for GraphiQL integration.
• codemirror-graphql - GraphQL mode and helpers for CodeMirror.
• graphql-schema - Create GraphQL schemas with a fluent/chainable interface.
• graphql-sequelize - Sequelize helpers for GraphQL.
• graphql-tools-sequelize - OO-style schema definition functions and schema resolver functions for GraphQL-Tools using Sequelize ORM
• graphql-tools-types - Custom GraphQL types for use with GraphQL-Tools (Void, Int, Float, String, Date, UUID, JSON)
• babel-plugin-graphql - Babel plugin that compile GraphQL tagged template strings.
• adrenaline - React bindings for Redux with Relay in mind.
• graphql-bookshelf - Some help defining GraphQL schema around BookshelfJS models.
• graph.ql - Faster and simpler technique for creating and querying GraphQL schemas.
• Strapi - Open-source Node.js framework that supports "GraphQL" out of the box.
• GraysQL - A GraphQL manager and loader.
• graysql-orm-loader - A GraysQL extension to load a GraphQL schema from an ORM.
• Annotated GraphQL - Proof of Concept for annotations in GraphQL (i.e.: transform an existing REST api into a GraphQL endpoint).
• Apollo Client - A well-documented GraphQL client that integrates with Redux. Has React and Angular bindings.
• graphql-tools - Tool library for building and maintaining GraphQL-JS servers.
• graphql-anywhere - Run a GraphQL query anywhere, against any data, with no schema.
• graphql-tag - A JavaScript template literal tag that parses GraphQL queries.
• modelizr - A library for simplifying the process of writing GraphQL queries, mocking them and normalizing their responses.
• vue-apollo - Vue integration for apollo.
• graphql-thinky - Build an optimized GraphQL schema from Thinky RethinkDB models.
• graphql-pouch - A GraphQL-API runtime on top of PouchDB created by GraphQL shorthand notation as a self contained service with CouchDB synchronization.
• gql-tools - Tool library with CLI for schema generation and manipulation.
• graphql-iso-date - A GraphQL date scalar type to be used with GraphQL.js. This scalar represents a date in the ISO 8601 format YYYY-MM-DD.
• graphql-compose - Tool which allows you to construct flexible graphql schema from different data sources via plugins.
• node-graphjoiner - Create GraphQL APIs using joins, SQL or otherwise.
• Join Monster - A GraphQL-to-SQL query execution layer for batch data fetching.
• graphql-factory - Create GraphQL types from JSON definitions
• type-o-rama - JS type systems interportability.

Relay Related

• graphql-relay-js - A library to help construct a graphql-js server supporting react-relay.
• sequelize-relay - Serverside library that connects sequelize and graphql-relay-js together.
• babel-plugin-react-relay - Babel Plugin for Relay with support for JSON & graphql-js schemas and URL endpoints.
• babel-relay-plugin - Babel Relay Plugin for transpiling GraphQL queries for use with Relay.
• react-router-relay - Relay integration for React Router.
• relay-local-schema - Use Relay without a GraphQL server.
• relay-sink - Use Relay to fetch and store data outside of a React component.
• recompose-relay - Recompose helpers for Relay.
• Graylay - A GraysQL extension to create a Relay compatible Schema.
• react-relay-network-layer - A network layer for Relay with query batching and middleware support (urlThunk, retryThunk, auth, defer and other).
• relay-subscriptions - Subscription support for Relay.
• Portfolio Relay Example - An example website that fetches data from various apis and uses Relay and GraphQL to feed the data to React components!

Ruby Libraries

• graphql-ruby - Ruby implementation of Facebook's GraphQL.
• graphql-relay-ruby - Relay helpers for GraphQL & Ruby.
• graphql-parser - A small ruby gem wrapping the libgraphqlparser C library for parsing GraphQL.
• graphql-client - A Ruby library for declaring, composing and executing GraphQL queries.
• graphql-batch - A query batching executor for the graphql gem.

PHP Libraries

• graphql-php - A PHP port of GraphQL reference implementation.
• graphql-relay-php - Relay helpers for GraphQL & PHP.
• laravel-graphql - Facebook GraphQL for Laravel 5.
• laravel-graphql-relay - A Laravel library to help construct a server supporting react-relay.
• graphql-mapper - This library allows to build a GraphQL schema based on your model.
• graphql-bundle - GraphQL Bundle for Symfony 2.
• overblog/graphql-bundle - This bundle provides tools to build a complete GraphQL server in your Symfony App. Supports react-relay.
• GraphQL – Well documented PHP implementation with no dependencies.
• GraphQL Symfony Bundle – GraphQL Bundle for the Symfony 3 (supports 2.6+).
• graphql-wp – a WordPress plugin that exposes a GraphQL endpoint.
• eZ Platform GraphQL Bundle - GraphQL Bundle for the eZ Platform Symfony CMS.
• GraphQL Middleware - GraphQL Psr7 Middleware
• Zend Expressive GraphiQL Extension - GraphiQL extension for zend expressive

Python Libraries

• graphql-parser - GraphQL parser for Python.
• graphql-core - GraphQL implementation for Python.
• graphql-relay-py - A library to help construct a graphql-py server supporting react-relay.
• graphql-parser-python - A python wrapper around libgraphqlparser.
• graphene - A package for creating GraphQL schemas/types in a Pythonic easy way.
• graphene-gae - Adds GraphQL support to Google AppEngine (GAE).
• django-graphiql - Integrate GraphiQL easily into your Django project.
• flask-graphql - Adds GraphQL support to your Flask application.
• python-graphql-client - Simple GraphQL client for Python 2.7+
• python-graphjoiner - Create GraphQL APIs using joins, SQL or otherwise.
• graphene-django - A Django integration for Graphene.
• Flask-GraphQL-Auth - An authentication library for Flask inspired from flask-jwt-extended.

Java Libraries

• graphql-java - GraphQL Java implementation.
• gaphql-java-type-generator - Auto-generates types for use with GraphQL Java
• schemagen-graphql - Schema generation and execution package that turns POJO's into a GraphQL Java queryable set of objects. Enables exposing any service as a GraphQL service using Annotations.
• graphql-java-annotations - Provides annotations-based syntax for schema definition with GraphQL Java.
• graphql-java-tools - Schema-first graphql-java convenience library that makes it easy to bring your own implementations as data resolvers. Inspired by graphql-tools for JS.
• graphql-java-servlet - A framework-agnostic java servlet for exposing graphql-java query endpoints with GET, POST, and multipart uploads.
• spring-graphql-common - Spring Framework GraphQL Library.
• graphql-spring-boot - GraphQL and GraphiQL Spring Framework Boot Starters.
• vertx-graphql-service-discovery - Asynchronous GraphQL service discovery and querying for your microservices.
• vertx-dataloader - Port of Facebook DataLoader for efficient, asynchronous batching and caching in clustered GraphQL environments
• Light Java GraphQL: A lightweight, fast microservices framework with all cross-cutting concerns addressed and ready to plug in GraphQL schema.

C/C++ Libraries

• libgraphqlparser - A GraphQL query parser in C++ with C and C++ APIs.

Go Libraries

• graphql - An implementation of GraphQL for Go follows graphql-js
• graphql-go - GraphQL server with a focus on ease of use (was https://github.com/neelance/graphql-go).
• GQLGen - Go generate based graphql server library.
• machinebox/graphql - Simple low-level GraphQL client for Go
• graphql-relay-go - A Go/Golang library to help construct a server supporting react-relay.
• graphql - GraphQL parser and server for Go.
• c-graphqlparser - Go-gettable version of the libgraphqlparser C library for parsing GraphQL.
• tallstreet-graphql - GraphQL parser and server for Go that leverages libgraphqlparser
• go-graphql - A powerful GraphQL server implementation for Golang

Scala Libraries

• sangria - Scala GraphQL client and server library.
• sangria-relay - Sangria Relay Support.
• graphql-scala - An attempt to get GraphQL going with Scala.

.NET Libraries

• graphql-dotnet - GraphQL for .NET.
• graphql-net - GraphQL to IQueryable for .NET

Elixir Libraries

• absinthe-graphql - Fully Featured Elixir GraphQL Library.
• graphql-elixir - GraphQL Elixir.
• plug_graphql - Plug integration for GraphQL Elixir.
• graphql_relay - Relay helpers for GraphQL Elixir.
• graphql_parser - Elixir bindings for libgraphqlparser
• graphql - Elixir GraphQL parser.
• plot - GraphQL parser and resolver for Elixir.

Haskell Libraries

• graphql-haskell - GraphQL AST and parser for Haskell.

SQL Libraries

• GraphpostgresQL - GraphQL for Postgres.
• sql-to-graphql - Generate a GraphQL API based on your SQL database structure.
• PostGraphQL - A GraphQL schema created by reflection over a PostgreSQL schema.

Lua Libraries

• graphql-lua - GraphQL for Lua.

Elm Libraries

• elm-graphql - GraphQL for Elm.

Clojure Libraries

• graphql-clj - A Clojure library designed to provide GraphQL implementation.

Swift Libraries

• GraphQL - The Swift implementation for GraphQL.

OCaml Libraries

• ocaml-graphql-server - GraphQL servers in OCaml.

Tools

• graphiql - An in-browser IDE for exploring GraphQL.
• GraphiQL.app - A light, Electron-based wrapper around GraphiQL.
• GraphQLviz - GraphQLviz marries GraphQL (schemas) with Graphviz.
• graphqlviz - GraphQL API visualizer in Node.js
• GraphQL AST Explorer - Explore the AST of a GraphQL document interactively
• GraphQLHub - Query public API's schemas (e.g. Reddit, Twitter, Github, etc) using GraphiQL
• js-graphql-intellij-plugin - GraphQL language support for IntelliJ IDEA and WebStorm, including Relay.QL tagged templates in JavaScript and TypeScript.
• gdom - DOM Traversing and Scraping using GraphQL.
• Annotated GraphQL Server - Server for annotated GraphQL showing how to transform a REST api into a GraphQL endpoint with annotations.
• Model Visualizer - A small webapp that generates an ERD-like visualization of a GraphQL endpoint from an introspection query.
• GraphQL Network - A chrome dev-tools extension for debugging GraphQL network requests.
• eslint-plugin-graphql - An ESLint plugin that checks your GraphQL strings against a schema.
• AST Explorer - Select "GraphQL" at the top, explore the GraphQL AST and highlight different parts by clicking in the query.
• vim-graphql - A Vim plugin that provides GraphQL file detection and syntax highlighting.
• GraphQL CMS - Use your existing GraphQL schema to generate simple for use, fully functional CMS in a couple steps.
• graphdoc - Static page generator for documenting GraphQL Schema.
• graphql-autocomplete - Autocomplete and lint from a GraphQL endpoint in Atom.
• GraphQL Code Generator - GraphQL code generator based on schema and documents.
• GraphQL IDE - An extensive IDE for exploring GraphQL API's.
• Swagger to GraphQL - GraphQL types builder based on REST API described in Swagger. Allows to migrate to GraphQL from REST for 5 minutes
• GraphQL Voyager - Represent any GraphQL API as an interactive graph.
• GraphQL Docs - Instantly create beautiful GraphQL API docs hosted online.
• GraphQL Faker - 🎲 Mock or extend your GraphQL API with faked data. No coding required.
• ts-graphql-plugin - A language service plugin complete and validate GraphQL query in TypeScript template strings.
• Apollo Launchpad - Like JSFiddle for GraphQL server code, write and deploy a GraphQL API directly from your browser.
• Apollo Tracing - GraphQL extension that enables you to easily get resolver-level performance information as part of a GraphQL response.
• Altair GraphQL Client - A beautiful feature-rich GraphQL Client for all platforms.
• Apollo Storybook Decorator - Wrap your React Storybook stories with Apollo Client, provide mocks for isolated UI testing with GraphQL
• GraphQL Metrics - instrument GraphQL resolvers, logging response times and statuses (if there was an error or not) to the console as well as to InfluxDB.
• GraphQL Rover - GraphQL schema interactive navigation, rearrange nodes, search and explore types and fields.
• json-graphql-server - Get a full fake GraphQL API with zero coding in less than 30 seconds, based on a JSON data file.
• Insomnia – An full-featured API client with first-party GraphQL query editor
• Prisma - Turn your database into a GraphQL API. Prisma lets you design your data model and have a production ready GraphQL API online in minutes.
• tuql - Automatically create a GraphQL server from any sqlite database.
• Bit - Organize GraphQL API as components to be consumed with NPM or modified from any project (example).
• RAN Toolkit - Production-ready toolkit/boilerplate with support for GraphQL, SSR, Hot-reload, CSS-in-JS, caching, and more.
• Apollo GraphQL VSCode Extension - Rich editor support for GraphQL client and server development that seamlessly integrates with the Apollo platform

Databases

• Dgraph - Scalable, distributed, low latency, high throughput Graph database with GraphQL as the query language

Services

• GraphCMS - GraphQL based Headless Content Management System.
• Graphcool - Your own GraphQL backend in under 5 minutes. Works with every GraphQL client such as Relay and Apollo.
• Reindex - Instant GraphQL Backend for Your React Apps.

Examples

JavaScript Examples

• react-starter-kit - Isomorphic web app boilerplate (Node.js/Express, GraphQL, React)
• graphql-starter-kit - Project template for building a GraphQL server with Node.js v7+ and JavaScript
• swapi-graphql - A GraphQL schema and server wrapping swapi.co.
• graphql-server - GraphQL server with Mongoose (MongoDB) and Node.js.
• graphql-intro - https://medium.com/@clayallsopp/your-first-graphql-server-3c766ab4f0a2
• graphql-aws - Amazon AWS GraphQL API Server.
• graffiti-todo - Example Relay TodoMVC application using graffiti-mongoose. WARNING Graffiti is no longer actively maintained. For hobbyist only.
• devknoll/gist:8b274f1c5d05230bfade
• UniversalRelayBoilerplate Boilerplate + examples for React Native (iOS, Android), React (isomorphic, Material-UI), Relay, GraphQL, JWT, Node.js, Apache Cassandra.
• vslinko/ripster
• relay-skeleton - React, Relay, GraphQL project skeleton
• simple-relay-starter - A very simple starter for React Relay using Browserify.
• relay-chat - an chat example showing Relay with routing and pagination.
• relay-todomvc - Relay TodoMVC with routing.
• graphql-express-sqlite - GraphQL server with Sqlite and Express
• koa-graphql-relay-example - Example of koa-graphql
• relay-fullstack - Relay Starter Kit integrated with Relay, GraphQL, Express, ES6/ES7, JSX, Webpack, Babel, Material Design Lite, and PostCSS.
• serverless-graphql-blog - A Serverless Blog leveraging GraphQL to offer a REST API with only 1 endpoint
• relay-cart - A simple shopping cart example leveraging relay & GraphQL with routing and pagination.
• graphql-loader - Example project to illustrate GraphQL, Express and Facebook DataLoader to connect to third party REST API
• swapi-graphql-lambda - A GraphQL schema hosted in AWS Lambda wrapping swapi.co
• Apollo Client documentation - Documentation and example for building GraphQL apps using apollo client
• Apollo Server tools documentation - Documentation, tutorial and examples for building GraphQL server and connecting to SQL, MongoDB and REST endpoints.
• f8-apollo - Refactored version of the official F8 app of 2016, powered by React Native and the Apollo Stack.
• f8app - Source code of the official F8 app of 2016, powered by React Native and other Facebook open source projects. makeitopen.com
• Reindex Examples - Example projects for Reindex with using React Native and React.js for web.
• Modelizr Documentation - Documentation and Usage Examples for modelizr
• Vue Apollo Example - Apollo example project for Vue 2.0.
• angular2-graphql-rest - An example app with REST Api working side by side with GraphQL using Apollo Client with angular2-apollo. Includes step-by-step tutorial how to migrate from REST to GraphQL.
• GraphQL-DataLoader-Boilerplate - Boilerplate to start your GraphQL with DataLoader server
• GraphQL-CEP - Query address by CEP
• Apollo React example for Github GraphQL API - Usage Examples Apollo React for Github GraphQL API with create-react-app
• Intuitive GraphQL Resolver Example - GraphQL application example using contextable.js.
• GraphQL Tutorial - A didactic 12-step introduction to GraphQL, starting from a simple Hello World to a network-based GraphQL server with a built-in GraphQL UI

TypeScript Examples

• Basic Apollo Server - Basic Starter for Apollo Server, Using typescript and Webpack.

Ruby Examples

• graphql-ruby-demo - Use graphql-ruby to expose a Rails app.
• github-graphql-rails-example - Example Rails app using GitHub's GraphQL API.
• relay-on-rails - Barebones starter kit for Relay application with Rails GraphQL server.
• relay-rails-blog - A graphql, relay and standard rails application powered demo weblog.
• [to_eat_app] (https://github.com/jcdavison/to_eat_app) - A sample graphql/rails/relay application with a related 3-part article series.

Go Examples

• golang-relay-starter-kit - Barebones starting point for a Relay application with Golang GraphQL server.
• golang-graphql-playground - An example Golang GraphQL server written with graphql-go and graphql-relay-go. Try live demo at: http://golanggraphqlplayground-sogko.rhcloud.com
• todomvc-relay-go - Port of the React/Relay TodoMVC app, driven by a Golang GraphQL backend.

Scala Examples

• sangria-akka-http-example - An example GraphQL server written with akka-http and sangria
• sangria-playground - An example of GraphQL server written with Play and sangria.

Python Examples

• swapi-graphene - A GraphQL schema and server using Graphene - View demo online.

Elixir Examples

• absinthe_example - Example usage of Absinthe GraphQL
• hello_graphql_phoenix - Examples of GraphQL Elixir Plug endpoints mounted in Phoenix - View demo online.

### Java Examples

• light-java-graphql examples - Examples of Light Java GraphQL and tutorials

Videos

• Zero to GraphQL in 30 Minutes
• Data fetching for React applications at Facebook
• React Native & Relay: Bringing Modern Web Techniques to Mobile
• Exploring GraphQL
• Creating a GraphQL Server
• GraphQL at The Financial Times
• Relay: An Application Framework For React
• Building and Deploying Relay with Facebook
• Introduction to GraphQL
• Exploring GraphQL@Scale
• What's Next for Phoenix by Chris McCord
• GraphQL with Nick Schrock
• Build a GraphQL server for Node.js using PostgreSQL/MySQL
• GraphQL server tutorial for Node.js with SQL, MongoDB and REST
• JavaScript Air Episode 023: Transitioning from REST to GraphQL
• GraphQL Future at react-europe 2016
• GraphQL at Facebook at react-europe 2016
• Building native mobile apps with GraphQL at react-europe 2016

Blogs

• Official GraphQL blog
• Building Apollo

Posts

• Using DataLoader to batch GraphQL requests
• Introducing Relay and GraphQL
• GraphQL Introduction
• Unofficial Relay FAQ
• Your First GraphQL Server
• GraphQL Overview - Getting Started with GraphQL and Node.js
• 4 Reasons you should try out GraphQL
• Moving from REST to GraphQL
• Writing a Basic API with GraphQL
• Building a GraphQL Server with Node.js and SQL
• GraphQL at The Financial Times
• Relay for visual learners
• Relay and Routing
• Learn Golang + GraphQL + Relay, Part 1: Your first Golang GraphQL server
• Learn Golang + GraphQL + Relay, Part 2: Your first Relay application
• From REST to GraphQL
• GraphQL: A data query language
• Subscriptions in GraphQL and Relay
• Relay 101: Building A Hacker News Client
• GraphQL Shorthand Notation Cheatsheet
• The GitHub GraphQL API
• Github GraphQL API React Example
• Testing a GraphQL Server using Jest
• How to implement viewerCanSee in GraphQL

Workshoppers

• GraphQL of Thrones - Total beginner tutorial focused on just GraphQL without all the tooling. Alternates between LEARN and PLAY modes roleplaying as Game of Thrones characters.
• How to GraphQL - Fullstack Tutorial Website with Tracks for all Major Frameworks & Languages including React, Apollo, Relay, JavaScript, Ruby, Java, Elixir and many more
• learning-graphql - An attempt to learn GraphQL.
• Let's Learn GraphQL - Lessons/walkthrough of GraphQL concepts.

License

To the extent possible under law, Chen-Tsu Lin has waived all copyright and related or neighboring rights to this work.