Skip to main content
View plugin on GitHub
See starters using this

Gatsby Plugin GraphQL Preview

A Gatsby plugin to automatically make the source-graphql parts of your application available as a live preview.

This works by doing the following:

  1. Grab the pages graphql query, isoloate the parts that belong to the remote graphql source and make it available to the page.
  2. If on the client, the query paramter perview has a truthy value, wrap the page inside an apollo setup, that replaces the statically queried remote data with fresh data queried on the client.
  3. Add a tiny UI to control how and when to re-query the data.

Only works conjunction with gatsby-source-graphql.

Install

with yarn

yarn add gatsby-plugin-graphql-preview
with npm
npm install --save gatsby-plugin-graphql-preview

How to use

Add the plugin to the plugins array in your gatsby-config.js.

It requires the same configuration options as gatsby-source-graphql. I’d suggest extracting the configuration into a variable instead of copying it.

gatsby-source-graphqls createLink is not yet supported. The url field is required.

The plugins own option(s) can be added by spreading the graphql options into a new object.

// In your gatsby-config.js

const graphqlOptions = {
  typeName: 'SWAPI',
  fieldName: 'swapi',
  url: 'https://api.graphcms.com/simple/v1/swapi',
};

module.exports = {
  plugins: [
    {
      resolve: 'gatsby-source-graphql',
      options: graphqlOptions,
    },
    {
      resolve: 'gatsby-plugin-graphql-preview',
      options: {
        ...graphqlOptions,
        previewQueryParam: 'preview', // preview is the default
      },
    },
  ],
};

Open a page that includes a query to your graphql-source and append ?<previewQueryParam>=1 to the pathname in the browser.

Example: localhost:8000/my-page?preview=1

The page should now include a small ui to configure in which interval the endpoint should be polled.


Docs
Tutorials
Plugins
Blog
Showcase