●Change8

Migrating to tRPC v11.0.0

Version v11.0.0 introduces 4 breaking changes. This guide details how to update your code.

Released: 3/21/2025

4
Breaking Changes
3
Migration Steps
6
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

initTRPCcreateTRPCNextrouter.interopTRPCClientErrorhttpBatchLinktransformer

Breaking Changes

●Issue #1

The minimum supported TypeScript version is now 5.1.0.

●Issue #2

The minimum supported Node.js version is now 18.x.

●Issue #3

The 'superjson' and 'transformer' configurations have been updated to require explicit imports in some environments to reduce bundle size.

●Issue #4

Internal types have been restructured; custom middleware that relied on private tRPC types may need updates.

Migration Steps

  1. 1
    Run 'npm install @trpc/server@latest @trpc/client@latest @trpc/react-query@latest @trpc/next@latest'.
  2. 2
    Check for any usage of 'router.interop()' and migrate to standard router definitions.
  3. 3
    Update transformer configurations if using 'superjson' to ensure compatibility with the new peer dependency requirements.

Release Summary

tRPC v11 introduces significant performance optimizations, improved Next.js App Router support, and raises the minimum requirements for Node.js and TypeScript.

Need More Details?

View the full release notes and all changes for tRPC v11.0.0.

View Full Changelog