Graphback CLI

Graphback helps you to kickstart your experience with any existing GraphQL implementation by generating backend and client side CRUD layer using your GraphQL data model. The CLI exposes a single generate command.

Installation

You can add Graphback CLI on your existing GraphQL project using either of the following commands.

With npm:

npm install --save-dev graphback-cli

Or with yarn:

yarn add --dev graphback-cli

Usage

Prerequisite

You project must contain the configuration file that follows the format described by the graphql-config.

Taking a .graphqlrc.yml configuration file for example, your configuration should have the following minimum required entry:

## Please review configuration and adjust it for your own project

schema: ./src/schema/schema.graphql

extensions:

graphback:

model: ./model/**/*.graphql

## You can add as many Graphback plugins as you wish

## Here we are only adding the Schema and Client plugin

plugins:

graphback-schema:

format: graphql

outputPath: ./src/schema/schema.graphql

graphback-client:

format: 'graphql'

outputFile: ./src/graphql/graphback.graphql

note

If you used graphql-cli to initialize the project, this file will be automatic setup for you. Otherwise, you can still use the init command from the CLI to initialize this configuration setup.

Using the command

To use Graphback generate command. In your package.json file, edit the scripts parts and add the following line:

"generate": "graphback generate"

And finally, use npm or yarn to run it:

With yarn:

yarn generate

With npm:

npm run generate

generate command will execute generation process that will generate GraphQL server based on your data model.

note

Graphback CLI is now part of the graphql-cli command line tool. Please consider installing it for wider set of features