This repository showcases a code-first approach to constructing a GraphQL schema, served via Apollo Server and queried / mutated via generated Apollo Client hooks.
The graph has been made using scalar types, enumerables, lists, interfaces and custom scalars. The client utilises code generation to take source GraphQL files and output type safe Apollo Client hooks ready for use within react components.
These instructions assume you already have docker and docker-compose installed. Common actions are as follows:
In order to correctly run the client container, we need to start the server container. This is because when the client starts itself, it will generate types and hooks for use within the application. There is a single command that will build the dev versions of both the client and server images (if necessary), start the server container, wait for the server to be responsive, then start the client container:
make start-apollo-client-devThere are a number of other commands available such as starting the server in isolation, type-checking the application and more. They can be found by running the following:
makeAlmost all of the scripts that interact with Apollo Server (including type-checking) need the generated schema and generated types files. That is why almost all of the scripts will have a pre-script that generates these artifacts.