[RFC] Bring your own GraphQL library

Right now Redwood ships with Apollo’s GraphQL client out of the box. We don’t know if that will change, but we would love to give you the ability to switch to the GraphQL client of your preference.

As a user, nothing will change if you’re happy with the GraphQL client! This is only for people who would want to change the client.

How does this work right now?

Right now we initialise the Apollo GraphQL library in <RedwoodProvider> where we do two things:

1. We grab the API_PROXY_PATH value from the redwood.toml configuration to point to the URL to your GraphQL server.
2. We determine if you’re users are authenticated and we put the appropriate Authorization headers into the GraphQL clients configuration.

How would you specify your own GraphQL client?

// ./web/src/index.js
return (
  <AuthProvider>
    <RedwoodProvider 
        graphQLClient={({ url, headers }) => new GraphQLClient(url, { headers })}
        queryHandler={({ query, variables }) => useQuery(query, { variables })}
    >
    </RedwoodProvider>
  </AuthProvider>
)

We would provide the url to your GraphQL server and headers to facilitate authentication, which you would pass to the configuration of your client. You would also need to let us know how to run run queries.

Let me know what you think!

[peterp]

I think it’s largely subjective, but maybe bundle size and simplicity are really important to your particular use case and you don’t need something as heavy as Apollo.

So, the main reason for this is to consider is that we used Apollo v2 and it took us several weeks to upgrade to v3. You might decide that there are features that are important for you and you don’t want to be trapped into whatever Redwood decides. Alternatively you might decide that you actually want to stay on v2 and don’t want to upgrade to v3 just yet.

[peterp]

We allow this now.