Skip to main content


Apollo Client is a comprehensive state management library for JavaScript that enables you to manage both local and remote data with GraphQL. Use it to fetch, cache, and modify application data, all while automatically updating your UI.

typed-graphql-builder can easily be used with Apollo Client by substituting the gql function that comes with it. Instead of using gql and passing it a query string:

const ADD_TODO = gql`
mutation AddTodo($type: String!) {
addTodo(type: $type) {

we can use typed-graphql-builder:

import { mutation } from "./generated-api"

const ADD_TODO = mutation(m => [
m.addTodo({ type: $("type") }, todo => [

The type of the variable will be automatically inferred as string for us.

The mutation can then be used in a component as usual. We can pass additional variables at the point of use:

function AddTodo() {
const [todo, setTodo] = useState("")
const [addTodo, { data, loading, error }] = useMutation(ADD_TODO)

if (loading) return "Submitting..."
if (error) return `Submission error! ${error.message}`

return (
onSubmit={e => {
addTodo({ variables: { type: todo } })
<input value={todo} onChange={e => setTodo(} />
<button type="submit">Add Todo</button>