node package manager
Easy collaboration. Discover, share, and reuse code in your team. Create a free org ¬Ľ

graphql-up

graphql-up

graphql-up is the fastest way to get a free & ready to use GraphQL API. It works out of the box with Apollo & Relay and supports GraphQL subscriptions.

Features

  • ūüöÄ Get a instant GraphQL API for your schema
  • ‚öõÔłŹ Optimized endpoints for Apollo & Relay
  • ūüĎ®‚ÄćūüŹę Easy to add to your own tutorials, docs & examples

Quickstart

type Tweet {
  id: ID! @isUnique
  text: String!
  author: User! @relation(name: "Tweets")
}
 
type User {
  id: ID! @isUnique
  name: String!
  tweets: [Tweet!]! @relation(name: "Tweets")
}

Copy the schema above and save it as twitter.graphql. (Read more about the IDL syntax.)

# Install the CLI via npm (or yarn) 
npm install -g graphql-up
 
# Create GraphQL API using your local schema file 
graphql-up twitter.graphql

This is how it should look like (see this video tutorial for more details):

Usage

  Usage: graphql-up <schema>
  
    Get a ready-to-use GraphQL API for your schema
    Read more at https://www.graph.cool/graphql-up/
    
  Examples:
    graphql-up twitter.graphql                          # local schema file 
    graphql-up https://graphqlbin.com/twitter.graphql   # fetch schema from URL 
    
    More examples: https://github.com/graphcool/graphql-up
 
  Options:
    --version, -v   Print version of graphql-up
    --help, -h      Show help message
    --minimal, -m   Only print URLs of created API
 

Local schema file

graphql-up twitter.graphql

Hosted schema file

graphql-up https://graphqlbin.com/twitter.graphql

How it works

You only need to provide the schema, graphql-up will create a GraphQL API for you. The actual magic happens on the servers sponsored by Graphcool.

Add graphql-up to your repositories/docs

You can easily add a graphql-up badge to your own tutorials, docs & examples. Just add the following Markdown snippet and replace the __SCHEMA_URL__ with a link to your schema file. (See here for a snippet generator.)

[![graphql-up](http://static.graph.cool/images/graphql-up.svg)](https://www.graph.cool/graphql-up/new?source=__SCHEMA_URL__)

Schema Examples

Do you have another interesting example in mind? Add it here. ūüďö

Help & Community Slack Status

Join our Slack community if you run into issues or have questions. We love talking to you!