Este artículo puede contener enlaces de afiliado. Si realizas una compra a través de ellos, recibo una pequeña comisión sin coste adicional para ti. Solo recomiendo herramientas que uso o conozco.

tRPC v11 con Next.js: APIs type-safe sin escribir esquemas

6 min read

Prerrequisitos: Next.js 14+ con App Router, TypeScript básico, conocer React Query (o estar dispuesto a aprender en el camino). Node.js 18+.

Si defines el tipo de respuesta de tu API en el server y luego lo vuelves a definir en el cliente — o peor, haces un as any para que compile — esto es para ti. tRPC resuelve el problema de raíz: el tipo del server viaja directo al cliente por inferencia de TypeScript, sin generar ningún archivo, sin schemas separados, sin ningún paso extra. En este artículo configuras tRPC v11 desde cero en un proyecto Next.js App Router: routers, procedures, validación con Zod, contexto de auth y React Query integrado.

REST duplica tipos entre server y cliente. tRPC los infiere directamente desde el router.

tRPC es ideal para proyectos TypeScript fullstack donde controlas server y cliente. Si necesitas una API pública que consuman terceros, o tienes servicios en otros lenguajes, REST o GraphQL siguen siendo la opción correcta.

Deberías ver los paquetes instalados sin errores de peer dependencies. Si aparece un conflicto entre versiones de @tanstack/react-query, fija la versión a ^5.0.0.