/nestjs-relay

A batteries-included toolkit for building Relay-compliant GraphQL APIs with NestJS v7

Primary LanguageTypeScriptMIT LicenseMIT

NestJS Relay

A batteries-included toolkit for building Relay-compliant GraphQL APIs with NestJS v7.

npm GitHub Workflow Status Vulnerabilities Coveralls Commitizen friendly

Background

Relay is a Javascript client for GraphQL that is designed for performance and large-scale applications.

Relay provides powerful abstractions for building client applications, however, in order to understand the structure of an application's data, Relay requires that you follow certain conventions when defining your schema.

The three core assumptions that Relay makes about a GraphQL server are that it provides:

  • A mechanism for refetching an object.
  • A description of how to page through connections.
  • Structure around mutations to make them predictable.

Features

  • Build a Relay-compliant GraphQL API without the hassle!

Getting Started

Prerequisites

  • NestJS GraphQL v7
  • Code-first methodology

Installation

# NPM
npm i --save nestjs-relay

# GitHub Release
npm i --save github:rogerballard/nestjs-relay

Peer dependencies:

npm i --save graphql-relay graphql

Guides

Further Reading

For further detail, please see the following resources.

Walkthroughs

Specifications

Contributing

Please see the contribution guidelines and the code of conduct.