#12727 b845906 Thanks @jerelmiller! - Add a codemod that renames old import locations from 3.x entrypoint to their 4.x entrypoint.
Run the codemod using the following command:
npx @apollo/client-codemod-migrate-3-to-4 --parser tsx ./src/**/*.{ts,tsx}
The codemod supports .js, .jsx, .ts, and .tsx files.
#12851 32bc830 Thanks @phryneas! - Add a new clientSetup codemod step which applies the following steps from the migration guide to your Apollo Client setup code:
uri, headers and credentials to the link option and creates a new HttpLink instancename and version into a clientAwareness optionlocalState option with a new LocalState instance, moves resolvers, and removes typeDefs and fragmentMatcher optionsconnectToDevTools option to devtools.enableddisableNetworkFetches to prioritizeCacheValuesdataMasking is enabled, adds a template for global type augmentation to re-enable data masking typesincrementalHandler option and adds a template for global type augmentation to accordingly type network responses in custom linksd1e9503 Thanks @phryneas! - Extend imports codemod, add new links and removals (via #12838) codemods.#12846 71ccfb5 Thanks @phryneas! - Add a new legacyEntryPoints transformation step that moves imports from old legacy entry points like @apollo/client/main.cjs or @apollo/client/react/react.cjs to the new entry points like @apollo/client or @apollo/client/react.
#12775 454ec78 Thanks @jerelmiller! - Don't export gql from @apollo/client/react entrypoint. Import from @apollo/client instead.
#12858 6440e8b Thanks @phryneas! - adjust the clientSetup codemod so that it removes the TCacheShape type argument from all ApolloClient usages (types and constructor calls).
Fetched April 11, 2026