phpsmarter / graphql-up Goto Github PK

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 @model {
  id: ID! @isUnique
  text: String!
  author: User! @relation(name: "Tweets")
}

type User @model {
  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 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

• Twitter
• Instagram

Do you have another interesting example in mind? Add it here. 📚

Help & Community

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