awesome-relay.md

Awesome Relay

Awesome resources for Relay , based on the Awesome project

Table of Contents

• Learning Resources
  • Documentation
  • FAQs
  • Tutorials
  • Overviews
  • Example Implementations
  • Lists of Lists
• Ecosystem
  • Libraries & Packages
  • Tooling
  • Starter Kits
• Relay-Specific Server Support
  • Go
  • JavaScript
  • Python
  • Ruby
  • Rails
  • Scala
• Testing

Learning Resources

Documentation

• Official Docs - Official Relay documentation.

FAQs

• Unofficial Relay FAQ - Common questions answered! Relay resources are scarce at the moment, so this is very helpful if you get stuck.

Tutorials

• Getting Started with Relay - One of the few detailed walk throughs of hand-on Relay.
• Relay 101: Building A Hacker News Client - A complete workable example.
  • Relay 102: Mutations - A follow up to "Relay 101" concentrating on mutations.
• Facebook Relay talk - Lunch and Learn session - Walkthrough of building a simple app, and demonstration of GraphiQL .
• A Beginner's Guide to Relay Mutations - Mutations in depth.

Overviews

• React Data Fetching with Relay - Clear conceptual overview of Relay's moving parts and magic.
• Joseph Savona - Relay: An Application Framework For React - Conceptual overview of Relay from the Facebook team.
• F8 2015 - React Native & Relay: Bringing Modern Web Techniques to Mobile - Overview of Relay, some about the philosophy.
• Relay - Daniel Dembach - Hamburg React.js Meetup - A good general overview of Relay, some discussion of alternatives. Common questions are covered in Q&A at the end.
• Facebook Relay talk - Lunch and Learn session - Walkthrough of building a simple app, and demonstration of GraphiQL .
• React with Relay and GraphQL with Andrew Smith - High level overview of Relay and GraphQL, with some useful discussion from the audience. Some discussion of other front-end frameworks, as well.
• Relay for Visual Learners - Very clear set of diagrams laying out how the different parts of Relay relate to each other.
• Relay: Seamless Syncing For React - An overview of what Relay is, and some discussion of experience using it in production.
• Cartoon Intro to Facebook's Relay - An overview of how Relay works, complete with illustrations.
  • Part 1: Saying what data you need with GraphQL
  • Part 2: Fetching data from the server
  • Part 3: Syncing changes back up to the server
  • Part 4: How it all fits together

Example Implementations

• Relay TODO MVC - The classic TODO example app, written with Relay. ^{★ 73, pushed 137 days ago}
• relay-chat - Relay with routing and pagination. ^{★ 71, pushed 266 days ago}
• koa-graphql-relay-example - "TODO" app with koa-graphql and relay . ^{★ 24, pushed 129 days ago}
• todomvc-relay-go - Relay TodoMVC app, driven by a Golang GraphQL backend. ^{★ 15, pushed 291 days ago}

Lists of Lists

• Relay and GraphQL Introduction Materials

Ecosystem

Libraries & Packages

• graphql-relay-js - Simplifies creating a JS GraphQL server for react-relay . ^{★ 460, pushed 133 days ago}
• Babel Relay Plugin - Use Relay the latest ES6+ syntax.
• react-router-relay - react-router bindings for Relay. Greatly simplifies many local state UI uses cases.
  • Relay and Routing - A well-articulated walk through of react-router-relay , and the problems that it solves.
  • relay-nested-routes - Generate nested routes that reflect nested data. Helpful for managing deep data.
  • isomorphic-relay-router - Server side rendering support for react-router-relay . ^{★ 64, pushed 127 days ago}
  ^{★ 356, pushed 126 days ago}
• relay-decorator - Simply syntax for Relay containers with ES7 decorators ( @ syntax) ^{★ 2, pushed 187 days ago}
• recompose-relay - Ease composition of Relay containers by currying and providing the component after the container.
• relay-local-schema - Use a local schema; no need for a remote GraphQL server. ^{★ 91, pushed 146 days ago}
• react-native-relay - Use Relay with React Native.
  • May be supported out of the box in the future.
  ^{★ 56, pushed 165 days ago}
• relay-sink - Use Relay to fetch and store data outside of a React component. ^{★ 107, pushed 273 days ago}
• babel-plugin-flow-relay-query - Convert Flow types into Relay fragments. ^{★ 10, pushed 130 days ago}
• sequelize-relay - Make Relay compatible with sequelize . ^{★ 41, pushed 224 days ago}
• relay-mongodb-connection - Create Relay connections from MongoDB cursors. ^{★ 4, pushed 293 days ago}
• relay-composite-network-layer - Compose your Relay Network Layer of many different Network Layers each with their own schema. ^{★ 28, pushed 251 days ago}
• react-relay-network-layer - A Network Layer that adds support for query-batching and middlewares. It additionally provides some useful middlewares such as for auth, for logging, etc.

Tooling

• GraphiQL - A library to introspect GraphQL, test queries and mutations.
  • GraphiQL App - A standalone app for viewing GraphQL, introspection docs, and testing queries/mutations. Invaluable for debugging your Relay app. ^{★ 186, pushed 201 days ago}
  ^{★ 1295, pushed 128 days ago}
• relay-local-schema - Use a local schema; no need for a remote GraphQL server.
• Babel Relay Plugin - Use Relay the latest ES6+ syntax.

Starter Kits

• Relay Skeleton - Relay project skeleton. ^{★ 94, pushed 196 days ago}
• Relay Starter Kit - An app that it already set up with a basic setup. Just clone and tweak to suit your needs! ^{★ 667, pushed 126 days ago}
• Simple Relay Starter - A Browserify version of the Relay Starter Kit . ^{★ 86, pushed 152 days ago}
• UniversalRelayBoilerplate Boilerplate + examples for React Native (iOS, Android), React (isomorphic, Material-UI), Relay, GraphQL, JWT, Node.js, Apache Cassandra. ^{★ 12, pushed 124 days ago}
• Relay on Rails Starter Kit - A barebones starter kit for Relay application on Rails server. Just clone and tweak! ^{★ 19, pushed 311 days ago}
• Relay Fullstack - Relay Starter Kit integrated with Relay, Express, Webpack, Babel, Material Design Lite, and PostCSS. ^{★ 333, pushed 127 days ago}

Relay-Specific Server Support

Go

• Go Relay - A Go/Golang library to help construct a graphql-go server supporting react-relay. ^{★ 63, pushed 180 days ago}
• todomvc-relay-go - React/Relay TodoMVC app, driven by a Golang GraphQL backend.

JavaScipt

• graphql-relay-js - Simplifies creating a JS GraphQL server for react-relay .

Python

• graphql-relay-py - A library to help construct a graphql-py server supporting react-relay . ^{★ 61, pushed 320 days ago}

Ruby

• graphql-relay-ruby - Relay helpers for GraphQL & Ruby. ^{★ 77, pushed 129 days ago}

Rails

• GraphQL and Relay on Rails — First relay powered react component - Full walk through of a simple Relay setup, including clonable code.
• Relay/GraphQL On Rails - A brief example of Relay with Rails, complete with several diagrams to aid in comprehension.
• Relay on Rails Starter Kit - A barebones starter kit for Relay application on Rails server. Just clone and tweak!

Scala

• sangria-relay - Relay support for Sangria . ^{★ 30, pushed 127 days ago}

Testing

• Writing Simple Unit Tests with Relay - An early first look at testing Relay.