Newman's Personal Motorcade

    graphql-playground-react
    TypeScript icon, indicating that this package has built-in type declarations

    1.7.28 • Public • Published

    GraphQL IDE for better development workflows (GraphQL Subscriptions, interactive docs & collaboration).
    You can download the desktop app or use the web version at graphqlbin.com: Demo

    Features

    • Context-aware autocompletion & error highlighting
    • 📚 Interactive, multi-column docs (keyboard support)
    • ⚡️ Supports real-time GraphQL Subscriptions

    FAQ

    How is this different from GraphiQL?

    GraphQL Playground uses components of GraphiQL under the hood but is meant as a more powerful GraphQL IDE enabling better (local) development workflows. Compared to GraphiQL, the GraphQL Playground ships with the following additional features:

    • Interactive, multi-column schema documentation
    • Automatic schema reloading
    • Support for GraphQL Subscriptions
    • Query history
    • Configuration of HTTP headers
    • Tabs

    See the following question for more additional features.

    What's the difference between the desktop app and the web version?

    The desktop app is the same as the web version but includes these additional features:

    • Support for graphql-config enabling features like multi-environment setups.
    • Double click on *.graphql files.

    How does GraphQL Bin work?

    You can easily share your Playgrounds with others by clicking on the "Share" button and sharing the generated link. You can think about GraphQL Bin like Pastebin for your GraphQL queries including the context (endpoint, HTTP headers, open tabs etc).

    You can also find the announcement blog post here.

    Usage

    Properties

    All interfaces, the React component <Playground /> and all middlewares expose the same set of options:

    • properties
      • endpoint [string] - the GraphQL endpoint url.
      • subscriptionEndpoint [string] - the GraphQL subscriptions endpoint url.
      • setTitle [boolean] - reflect the current endpoint in the page title

    As React Component

    Install

    yarn add graphql-playground-react

    Use

    GraphQL Playground provides a React component responsible for rendering the UI and Session management. There are 3 dependencies needed in order to run the graphql-playground React component.

    1. Open Sans and Source Code Pro fonts
    2. Rendering the <Playground /> component

    The GraphQL Playground requires React 16.

    Including Fonts (1.)

    <link
      href="https://fonts.googleapis.com/css?family=Open+Sans:300,400,600,700|Source+Code+Pro:400,700"
      rel="stylesheet"
    />

    Including stylesheet and the component (2., 3.)

    import React from 'react'
    import ReactDOM from 'react-dom'
    import Playground from 'graphql-playground'
    
    ReactDOM.render(
      <Playground endpoint='https://api.graph.cool/simple/v1/swapi' />,
      document.body,
    )

    As Server Middleware

    Install

    # Pick the one that matches your server framework
    yarn add graphql-playground-middleware-express  # for Express or Connect
    yarn add graphql-playground-middleware-hapi
    yarn add graphql-playground-middleware-koa
    yarn add graphql-playground-middleware-lambda

    Usage with example

    We have a full example for each of the frameworks below:

    As serverless handler

    Install

    yarn add graphql-playground-middleware-lambda

    Usage

    handler.js

    import lambdaPlayground from 'graphql-playground-middleware-lambda'
    // or using require()
    // const lambdaPlayground = require('graphql-playground-middleware-lambda').default
    
    exports.graphqlHandler = function graphqlHandler(event, context, callback) {
      function callbackFilter(error, output) {
        // eslint-disable-next-line no-param-reassign
        output.headers['Access-Control-Allow-Origin'] = '*'
        callback(error, output)
      }
    
      const handler = graphqlLambda({ schema: myGraphQLSchema })
      return handler(event, context, callbackFilter)
    }
    
    exports.playgroundHandler = lambdaPlayground({
      endpoint: '/dev/graphql',
    })

    serverless.yml

    functions:
      graphql:
        handler: handler.graphqlHandler
        events:
          - http:
              path: graphql
              method: post
              cors: true
      playground:
        handler: handler.playgroundHandler
        events:
          - http:
              path: playground
              method: get
              cors: true

    Development npm version

    This is a mono-repo setup containing packages for the graphql-playground and graphql-playground-electron.

    $ cd packages/graphql-playground
    $ yarn
    $ yarn start

    Open localhost:3000/localDev.html?endpoint=https://api.graph.cool/simple/v1/swapi for local development!

    Help & Community Discord

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

    Keywords

    none

    Install

    npm i graphql-playground-react

    DownloadsWeekly Downloads

    8,807

    Version

    1.7.28

    License

    MIT

    Unpacked Size

    23.7 MB

    Total Files

    544

    Last publish

    Collaborators

    • schickling
    • timsuchanek
    • jasonkuhrt
    • acao
    • divyenduz
    • huvik