kissu / gridsome-source-graphql-prismic

GraphQL source for Gridsome forked for a Prismic implementation

Forked to be used with prismic

original: https://gridsome.org/plugins/@gridsome/source-graphql

@gridsome/source-graphql

Pull a remote GraphQL schema in locally

Install

• yarn add gridsome-source-graphql-prismic
• npm install gridsome-source-graphql-prismic

Usage

module.exports = {
  plugins: [
    {
      use: "gridsome-source-graphql-prismic",
      options: {
        url: "https://your-repository.prismic.io",
        fieldName: 'prismicio',
        typeName: 'prismicio',

        headers: { 
          'Prismic-Ref': ``, // useMasterRef will overload this line
          'Authorization': `Token `,
        }

        useMasterRef: true // undefined by default
      }
    }
  ]
};

Options

url

• Type: string required

The URL of a GraphQL API endpoint to request your schema from.

fieldName

• Type: string required

The name that should be used to namespace your remote schema when it's merged in, so that it doesn't conflict with any local data.

For instance, if you put "prismicio" your remote schema's data will be available by querying like so:

query {
  prismicio {
    helloWorld
  }
}

typeName

• Type: string
• Defaults: fieldName

The prefix to be used for your imported schema's field types.

headers

• Type: object

An object of headers to be passed along with your request to the API endpoint. This will generally be used to authenticate your request.

useMasterRef

• Type: boolean

This boolean allows you to automaticaly use the Prismic master REF

Note: For safety, you should pass any sensitive tokens/passwords as environmental variables. To learn more, see the Gridsome Docs on Environmental Variables.