Managing local state

At its core, Apollo Client is a state management library that happens to use GraphQL to interact with a remote server. Naturally, some application state doesn't require a remote server because it's entirely local.

Apollo Client enables you to manage local state alongside remotely fetched state, meaning you can interact with all of your application's state with a single API.

How it works

You can store your application's local state any way you want (such as in localStorage or the Apollo Client cache). You then define the logic that Apollo Client uses to fetch and populate that local data when you query a particular field. You can even include both local and remotely fetched fields in the same query:

To support this flow, Apollo Client 3 introduces two complementary mechanisms for managing local state:

Field policies enable you to define what happens when you query a particular field, including fields that aren't defined in your GraphQL server's schema. By defining field policies for these local-only fields, you can populate them with data that's stored anywhere, such as in localStorage or

A single GraphQL query can include both local-only fields and remotely fetched fields. In the field policy for each local-only field, you specify a function that defines how that field's value is populated.

Reactive variables enable you to read and write local data anywhere in your application, without needing to use a GraphQL operation to do so. The

Reactive variables aren't stored in the Apollo Client cache, so they don't need to conform to the strict structure of a cached type. You can store anything you want in them.

Whenever the value of a reactive variable changes, Apollo Client automatically detects that change. Every active query with a field that depends on the changed variable automatically updates.

In earlier versions of Apollo Client, you define local resolvers to populate and modify local-only fields. These resolvers are similar in structure and purpose to the

This functionality is still available in Apollo Client 3, but will be moved out of the core module in a future major release.