node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org ¬Ľ



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.


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


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: graphql-up <schema>
    Get a ready-to-use GraphQL API for your schema
    Read more at
    graphql-up twitter.graphql                          # local schema file 
    graphql-up   # fetch schema from URL 
    More examples:
    --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


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.)


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!