Skip to content

createTRPCNuxtHandler

The createTRPCNuxtHandler is an adapter that extends the Fetch / Edge runtime adapter, sets a default endpoint (/api/trpc), and passes the H3 event object to your contexts.

server/api/trpc/[trpc].ts
import { createTRPCNuxtHandler } from 'trpc-nuxt/server';
import { createTRPCContext } from '~/server/trpc/init';
import { appRouter } from '~/server/trpc/routers';
export default createTRPCNuxtHandler({
router: appRouter,
createContext: createTRPCContext,
});

On Nuxt 4.6 or later, import from trpc-nuxt/server/future. Its createContext receives Nuxt’s RequestEvent from nuxt/server instead of h3’s H3Event. In the next major release, this handler moves to trpc-nuxt/server.

server/api/trpc/[trpc].ts
import { createTRPCNuxtHandler } from 'trpc-nuxt/server/future';
import { createTRPCContext } from '~/server/trpc/init';
import { appRouter } from '~/server/trpc/routers';
export default createTRPCNuxtHandler({
router: appRouter,
createContext: createTRPCContext,
});