From 27745b6de6168dfc83802f48da488da7111ebafc Mon Sep 17 00:00:00 2001
From: unnoq <contact@unnoq.com>
Date: Tue, 26 Aug 2025 14:08:18 +0700
Subject: [PATCH 1/4] docs: Migrating from tRPC

---
 apps/content/.vitepress/config.ts         |   7 +
 apps/content/docs/migrations/from-trpc.md | 448 ++++++++++++++++++++++
 2 files changed, 455 insertions(+)
 create mode 100644 apps/content/docs/migrations/from-trpc.md

diff --git a/apps/content/.vitepress/config.ts b/apps/content/.vitepress/config.ts
index 2bab15846..806d6887d 100644
--- a/apps/content/.vitepress/config.ts
+++ b/apps/content/.vitepress/config.ts
@@ -220,6 +220,13 @@ export default withMermaid(defineConfig({
             { text: 'Validation Errors', link: '/docs/advanced/validation-errors' },
           ],
         },
+        {
+          text: 'Migrations',
+          collapsed: true,
+          items: [
+            { text: 'Migrating from tRPC', link: '/docs/migrations/from-trpc' },
+          ],
+        },
         {
           text: 'Others',
           collapsed: true,
diff --git a/apps/content/docs/migrations/from-trpc.md b/apps/content/docs/migrations/from-trpc.md
new file mode 100644
index 000000000..e7bce5183
--- /dev/null
+++ b/apps/content/docs/migrations/from-trpc.md
@@ -0,0 +1,448 @@
+---
+title: Migrating from tRPC
+description: A comprehensive guide to migrate your tRPC application to oRPC
+---
+
+# Migrating from tRPC
+
+This guide will help you migrate your existing tRPC application to oRPC. Since oRPC draws significant inspiration from tRPC, the migration process should feel familiar and straightforward.
+
+::: info
+For a quick way to enhance your existing tRPC app with oRPC features without fully migrating, refer to the [tRPC Integration](/docs/openapi/integrations/trpc).
+:::
+
+## Core Concepts Comparison
+
+| Concept               | tRPC                         | oRPC                |
+| --------------------- | ---------------------------- | ------------------- |
+| **Router**            | `t.router()`                 | an object           |
+| **Procedure**         | `t.procedure`                | `os`                |
+| **Context**           | `t.context()`                | `os.$context()`     |
+| **Create Middleware** | `t.middleware()`             | `os.middleware()`   |
+| **Use Middleware**    | `t.procedure.use()`          | `os.use()`          |
+| **Input Validation**  | `t.procedure.input(schema)`  | `os.input(schema)`  |
+| **Output Validation** | `t.procedure.output(schema)` | `os.output(schema)` |
+| **Error Handling**    | `TRPCError`                  | `ORPCError`         |
+| **Serializer**        | `superjson`                  | built-in            |
+
+::: info
+Learn more about [oRPC vs tRPC Comparison](/docs/comparison)
+:::
+
+## Step-by-Step Migration
+
+### 1. Installation
+
+First, install oRPC and remove tRPC dependencies:
+
+::: code-group
+
+```sh [npm]
+npm uninstall @trpc/server @trpc/client @trpc/tanstack-react-query
+npm install @orpc/server@latest @orpc/client@latest @orpc/tanstack-query@latest
+```
+
+```sh [yarn]
+yarn remove @trpc/server @trpc/client @trpc/tanstack-react-query
+yarn add @orpc/server@latest @orpc/client@latest @orpc/tanstack-query@latest
+```
+
+```sh [pnpm]
+pnpm remove @trpc/server @trpc/client @trpc/tanstack-react-query
+pnpm add @orpc/server@latest @orpc/client@latest @orpc/tanstack-query@latest
+```
+
+```sh [bun]
+bun remove @trpc/server @trpc/client @trpc/tanstack-react-query
+bun add @orpc/server@latest @orpc/client@latest @orpc/tanstack-query@latest
+```
+
+```sh [deno]
+deno remove npm:@trpc/server npm:@trpc/client npm:@trpc/tanstack-react-query
+deno install npm:@orpc/server@latest npm:@orpc/client@latest npm:@orpc/tanstack-query@latest
+```
+
+:::
+
+### 2. Initialize
+
+Initialization is an optional step in oRPC. You can use `os` directly without initialization, but for reusability and better code organization, it's recommended to initialize your base procedures.
+
+::: code-group
+
+```ts [orpc/base.ts]
+import { ORPCError, os } from '@orpc/server'
+
+export async function createRPCContext(opts: { headers: Headers }) {
+  const session = await auth()
+
+  return {
+    headers: opts.headers,
+    session,
+  }
+}
+
+const o = os.$context<Awaited<ReturnType<typeof createRPCContext>>>()
+
+const timingMiddleware = o.middleware(async ({ next, path }) => {
+  const start = Date.now()
+
+  try {
+    return await next()
+  }
+  finally {
+    console.log(`[oRPC] ${path} took ${Date.now() - start}ms to execute`)
+  }
+})
+
+export const publicProcedure = o.use(timingMiddleware)
+
+export const protectedProcedure = publicProcedure.use(({ context, next }) => {
+  if (!context.session?.user) {
+    throw new ORPCError('UNAUTHORIZED')
+  }
+
+  return next({
+    context: {
+      session: { ...context.session, user: context.session.user }
+    }
+  })
+})
+```
+
+```ts [trpc/base.ts]
+import { initTRPC, TRPCError } from '@trpc/server'
+import superjson from 'superjson'
+
+export async function createRPCContext(opts: { headers: Headers }) {
+  const session = await auth()
+
+  return {
+    headers: opts.headers,
+    session,
+  }
+}
+
+const t = initTRPC.context<typeof createRPCContext>().create({
+  transformer: superjson,
+})
+
+export const createTRPCRouter = t.router
+
+const timingMiddleware = t.middleware(async ({ next, path }) => {
+  const start = Date.now()
+
+  const result = await next()
+
+  const end = Date.now()
+  console.log(`[tRPC] ${path} took ${end - start}ms to execute`)
+
+  return result
+})
+
+export const publicProcedure = t.procedure.use(timingMiddleware)
+
+export const protectedProcedure = t.procedure
+  .use(timingMiddleware)
+  .use(({ ctx, next }) => {
+    if (!ctx.session?.user) {
+      throw new TRPCError({ code: 'UNAUTHORIZED' })
+    }
+
+    return next({
+      ctx: {
+        session: { ...ctx.session, user: ctx.session.user },
+      },
+    })
+  })
+```
+
+:::
+
+::: info
+Learn more about oRPC [Context](/docs/context), and [Middleware](/docs/middleware).
+:::
+
+### 3. Procedures
+
+In oRPC, there are no separate `.query`, `.mutation`, or `.subscription` methods. Instead, use `.handler` for all procedure types.
+
+::: code-group
+
+```ts [orpc/routers/planet.ts]
+export const planetRouter = {
+  list: publicProcedure
+    .input(z.object({ cursor: z.number().int().default(0) }))
+    .handler(({ input }) => {
+      // Logic here
+
+      return {
+        planets: [
+          {
+            name: 'Earth',
+            distanceFromSun: 149.6,
+          }
+        ],
+        nextCursor: input.cursor + 1,
+      }
+    }),
+
+  create: protectedProcedure
+    .input(z.object({
+      name: z.string().min(1),
+      distanceFromSun: z.number().positive()
+    }))
+    .handler(async ({ context, input }) => {
+      // Logic here
+    }),
+}
+```
+
+```ts [trpc/routers/planet.ts]
+export const planetRouter = createTRPCRouter({
+  list: publicProcedure
+    .input(z.object({ cursor: z.number().int().default(0) }))
+    .query(({ input }) => {
+      // Logic here
+
+      return {
+        planets: [
+          {
+            name: 'Earth',
+            distanceFromSun: 149.6,
+          }
+        ],
+        nextCursor: input.cursor + 1,
+      }
+    }),
+
+  create: protectedProcedure
+    .input(z.object({
+      name: z.string().min(1),
+      distanceFromSun: z.number().positive()
+    }))
+    .mutation(async ({ ctx, input }) => {
+      // Logic here
+    }),
+})
+```
+
+:::
+
+::: info
+Learn more about oRPC [Procedures](/docs/procedures).
+:::
+
+### 4. App Router
+
+The main router structure is similar between tRPC and oRPC, except in oRPC you don't need to wrap routers in a `.router` call - plain objects is enough.
+
+::: code-group
+
+```ts [orpc/router/index.ts]
+import { planetRouter } from './planet'
+
+export const appRouter = {
+  planet: planetRouter,
+}
+```
+
+```ts [trpc/router/index.ts]
+import { planetRouter } from './planet'
+
+export const appRouter = createTRPCRouter({
+  planet: planetRouter,
+})
+```
+
+:::
+
+::: info
+Learn more about oRPC [Router](/docs/router).
+:::
+
+### 5. Error Handling
+
+::: code-group
+
+```ts [orpc]
+throw new ORPCError('BAD_REQUEST', {
+  message: 'Invalid input',
+  data: 'some data',
+  cause: validationError
+})
+```
+
+```ts [trpc]
+throw new TRPCError({
+  code: 'BAD_REQUEST',
+  message: 'Invalid input',
+  data: 'some data',
+  cause: validationError
+})
+```
+
+:::
+
+::: info
+Learn more about oRPC [Error Handling](/docs/error-handling).
+:::
+
+### 6. Server Setup
+
+This example assumes you're using [Next.js](https://nextjs.org/). If you're using a different framework, check the [oRPC HTTP Adapters](/docs/adapters/http) documentation.
+
+::: code-group
+
+```ts [app/api/orpc/[[...rest]]/route.ts]
+import { RPCHandler } from '@orpc/server/fetch'
+
+const handler = new RPCHandler(appRouter, {
+  interceptors: [
+    async ({ next }) => {
+      try {
+        return await next()
+      }
+      catch (error) {
+        console.error(error)
+        throw error
+      }
+    }
+  ]
+})
+
+async function handleRequest(request: Request) {
+  const { response } = await handler.handle(request, {
+    prefix: '/api/orpc',
+    context: await createORPCContext(request)
+  })
+
+  return response ?? new Response('Not found', { status: 404 })
+}
+
+export const GET = handleRequest
+export const POST = handleRequest
+```
+
+```ts [app/api/trpc/[trpc]/route.ts]
+import { fetchRequestHandler } from '@trpc/server/adapters/fetch'
+
+function handler(req: Request) {
+  return fetchRequestHandler({
+    endpoint: '/api/trpc',
+    req,
+    router: appRouter,
+    createContext: () => createTRPCContext(req),
+    onError: ({ path, error }) => {
+      console.error(
+        `❌ tRPC failed on ${path ?? '<no-path>'}: ${error.message}`
+      )
+    }
+  })
+}
+
+export { handler as GET, handler as POST }
+```
+
+:::
+
+### 7. Client Setup
+
+::: code-group
+
+```ts [orpc/client.ts]
+import { createORPCClient, onError } from '@orpc/client'
+import { RPCLink } from '@orpc/client/fetch'
+import { RouterClient } from '@orpc/server'
+
+const link = new RPCLink({
+  url: 'http://localhost:3000/api/orpc',
+  interceptors: [
+    onError((error) => {
+      console.error(error)
+    })
+  ],
+})
+
+export const client: RouterClient<typeof appRouter> = createORPCClient(link)
+
+// ---------------- Usage ----------------
+
+const { planets } = await client.planet.list({ cursor: 0 })
+```
+
+```ts [trpc/client.ts]
+import { createTRPCProxyClient, httpLink } from '@trpc/client'
+
+export const client = createTRPCProxyClient<typeof appRouter>({
+  links: [
+    httpLink({
+      url: 'http://localhost:3000/api/trpc'
+    })
+  ]
+})
+
+// ---------------- Usage ----------------
+
+const { planets } = await client.planet.list.query({ cursor: 0 })
+```
+
+:::
+
+::: info
+Learn more about oRPC [Client-Side Clients](/docs/client/client-side), [Batch Requests Plugin](/docs/plugins/batch-requests), and [Dedupe Requests Plugin](/docs/plugins/dedupe-requests).
+:::
+
+### 8. TanStack Query (React) Integration
+
+The oRPC TanStack Query integration is similar to tRPC, but simpler - you can use the `orpc` utilities directly without React providers or special hooks.
+
+::: code-group
+
+```ts [orpc/tanstack-query.ts]
+import { createTanstackQueryUtils } from '@orpc/tanstack-query'
+
+export const orpc = createTanstackQueryUtils(client)
+
+// ---------------- Usage in React Components ----------------
+
+const query = useQuery(orpc.planet.list.queryOptions({
+  input: { cursor: 0 },
+}))
+
+const infinite = useInfiniteQuery(orpc.planet.list.infiniteOptions({
+  input: (page: number) => ({ cursor: page }),
+  initialPageParam: 0,
+  getNextPageParam: lastPage => lastPage.nextCursor,
+}))
+
+const mutation = useMutation(orpc.planet.create.mutationOptions())
+```
+
+```ts [trpc/tanstack-query.ts]
+import { createTRPCContext } from '@trpc/tanstack-react-query'
+
+export const { TRPCProvider, useTRPC, useTRPCClient } = createTRPCContext<typeof appRouter>()
+
+// ---------------- Usage in React Components ----------------
+
+const trpc = useTRPC()
+
+const query = useQuery(trpc.planet.list.queryOptions({ cursor: 0 }))
+
+const infinite = useInfiniteQuery(trpc.planet.list.infiniteQueryOptions(
+  {},
+  {
+    initialCursor: 0,
+    getNextPageParam: lastPage => lastPage.nextCursor,
+  }
+))
+
+const mutation = useMutation(trpc.planet.create.mutationOptions())
+```
+
+:::
+
+::: info
+Learn more about oRPC [TanStack Query Integration](/docs/integrations/tanstack-query).
+:::

From 3b241e04727c8c45b6436d61168a6819f9a046bf Mon Sep 17 00:00:00 2001
From: unnoq <contact@unnoq.com>
Date: Tue, 26 Aug 2025 14:15:33 +0700
Subject: [PATCH 2/4] dead links

---
 apps/content/docs/migrations/from-trpc.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/apps/content/docs/migrations/from-trpc.md b/apps/content/docs/migrations/from-trpc.md
index e7bce5183..06929e23d 100644
--- a/apps/content/docs/migrations/from-trpc.md
+++ b/apps/content/docs/migrations/from-trpc.md
@@ -230,7 +230,7 @@ export const planetRouter = createTRPCRouter({
 :::
 
 ::: info
-Learn more about oRPC [Procedures](/docs/procedures).
+Learn more about oRPC [Procedures](/docs/procedure).
 :::
 
 ### 4. App Router

From 531b52c8d530da27dc90204f08b5090f617112d6 Mon Sep 17 00:00:00 2001
From: unnoq <contact@unnoq.com>
Date: Tue, 26 Aug 2025 14:20:58 +0700
Subject: [PATCH 3/4] deno add

---
 apps/content/docs/client/client-side.md                         | 2 +-
 apps/content/docs/contract-first/define-contract.md             | 2 +-
 apps/content/docs/contract-first/implement-contract.md          | 2 +-
 apps/content/docs/getting-started.md                            | 2 +-
 apps/content/docs/integrations/durable-event-iterator.md        | 2 +-
 apps/content/docs/integrations/hey-api.md                       | 2 +-
 apps/content/docs/integrations/opentelemetry.md                 | 2 +-
 apps/content/docs/integrations/pinia-colada.md                  | 2 +-
 apps/content/docs/integrations/react-swr.md                     | 2 +-
 apps/content/docs/integrations/sentry.md                        | 2 +-
 apps/content/docs/integrations/tanstack-query-old/react.md      | 2 +-
 apps/content/docs/integrations/tanstack-query-old/solid.md      | 2 +-
 apps/content/docs/integrations/tanstack-query-old/svelte.md     | 2 +-
 apps/content/docs/integrations/tanstack-query-old/vue.md        | 2 +-
 apps/content/docs/integrations/tanstack-query.md                | 2 +-
 apps/content/docs/migrations/from-trpc.md                       | 2 +-
 apps/content/docs/openapi/client/openapi-link.md                | 2 +-
 apps/content/docs/openapi/getting-started.md                    | 2 +-
 .../docs/openapi/integrations/implement-contract-in-nest.md     | 2 +-
 apps/content/docs/openapi/integrations/trpc.md                  | 2 +-
 apps/content/docs/openapi/openapi-handler.md                    | 2 +-
 apps/content/docs/openapi/openapi-specification.md              | 2 +-
 apps/content/docs/openapi/plugins/smart-coercion.md             | 2 +-
 apps/content/docs/openapi/plugins/zod-smart-coercion.md         | 2 +-
 apps/content/docs/server-action.md                              | 2 +-
 25 files changed, 25 insertions(+), 25 deletions(-)

diff --git a/apps/content/docs/client/client-side.md b/apps/content/docs/client/client-side.md
index c3a1dec6c..ea139d394 100644
--- a/apps/content/docs/client/client-side.md
+++ b/apps/content/docs/client/client-side.md
@@ -28,7 +28,7 @@ bun add @orpc/client@latest
 ```
 
 ```sh [deno]
-deno install npm:@orpc/client@latest
+deno add npm:@orpc/client@latest
 ```
 
 :::
diff --git a/apps/content/docs/contract-first/define-contract.md b/apps/content/docs/contract-first/define-contract.md
index 6a40792f9..c01b9d827 100644
--- a/apps/content/docs/contract-first/define-contract.md
+++ b/apps/content/docs/contract-first/define-contract.md
@@ -30,7 +30,7 @@ bun add @orpc/contract@latest
 ```
 
 ```sh [deno]
-deno install npm:@orpc/contract@latest
+deno add npm:@orpc/contract@latest
 ```
 
 :::
diff --git a/apps/content/docs/contract-first/implement-contract.md b/apps/content/docs/contract-first/implement-contract.md
index 910e52bd0..69ce1800f 100644
--- a/apps/content/docs/contract-first/implement-contract.md
+++ b/apps/content/docs/contract-first/implement-contract.md
@@ -28,7 +28,7 @@ bun add @orpc/server@latest
 ```
 
 ```sh [deno]
-deno install npm:@orpc/server@latest
+deno add npm:@orpc/server@latest
 ```
 
 :::
diff --git a/apps/content/docs/getting-started.md b/apps/content/docs/getting-started.md
index 4559c06c6..7136c1631 100644
--- a/apps/content/docs/getting-started.md
+++ b/apps/content/docs/getting-started.md
@@ -38,7 +38,7 @@ bun add @orpc/server@latest @orpc/client@latest
 ```
 
 ```sh [deno]
-deno install npm:@orpc/server@latest npm:@orpc/client@latest
+deno add npm:@orpc/server@latest npm:@orpc/client@latest
 ```
 
 :::
diff --git a/apps/content/docs/integrations/durable-event-iterator.md b/apps/content/docs/integrations/durable-event-iterator.md
index e73da3b50..5741c1fc9 100644
--- a/apps/content/docs/integrations/durable-event-iterator.md
+++ b/apps/content/docs/integrations/durable-event-iterator.md
@@ -32,7 +32,7 @@ bun add @orpc/experimental-durable-event-iterator@latest
 ```
 
 ```sh [deno]
-deno install npm:@orpc/experimental-durable-event-iterator@latest
+deno add npm:@orpc/experimental-durable-event-iterator@latest
 ```
 
 :::
diff --git a/apps/content/docs/integrations/hey-api.md b/apps/content/docs/integrations/hey-api.md
index 924b4b107..9ab73a45c 100644
--- a/apps/content/docs/integrations/hey-api.md
+++ b/apps/content/docs/integrations/hey-api.md
@@ -32,7 +32,7 @@ bun add @orpc/hey-api@latest
 ```
 
 ```sh [deno]
-deno install npm:@orpc/hey-api@latest
+deno add npm:@orpc/hey-api@latest
 ```
 
 :::
diff --git a/apps/content/docs/integrations/opentelemetry.md b/apps/content/docs/integrations/opentelemetry.md
index 6e6fcabb2..9c9f72ecd 100644
--- a/apps/content/docs/integrations/opentelemetry.md
+++ b/apps/content/docs/integrations/opentelemetry.md
@@ -38,7 +38,7 @@ bun add @orpc/otel@latest
 ```
 
 ```sh [deno]
-deno install npm:@orpc/otel@latest
+deno add npm:@orpc/otel@latest
 ```
 
 :::
diff --git a/apps/content/docs/integrations/pinia-colada.md b/apps/content/docs/integrations/pinia-colada.md
index 7f881f9bc..83e44da14 100644
--- a/apps/content/docs/integrations/pinia-colada.md
+++ b/apps/content/docs/integrations/pinia-colada.md
@@ -36,7 +36,7 @@ bun add @orpc/vue-colada@latest @pinia/colada@latest
 ```
 
 ```sh [deno]
-deno install npm:@orpc/vue-colada@latest npm:@pinia/colada@latest
+deno add npm:@orpc/vue-colada@latest npm:@pinia/colada@latest
 ```
 
 :::
diff --git a/apps/content/docs/integrations/react-swr.md b/apps/content/docs/integrations/react-swr.md
index 3a6808865..a5ec5ebcf 100644
--- a/apps/content/docs/integrations/react-swr.md
+++ b/apps/content/docs/integrations/react-swr.md
@@ -32,7 +32,7 @@ bun add @orpc/experimental-react-swr@latest
 ```
 
 ```sh [deno]
-deno install npm:@orpc/experimental-react-swr@latest
+deno add npm:@orpc/experimental-react-swr@latest
 ```
 
 :::
diff --git a/apps/content/docs/integrations/sentry.md b/apps/content/docs/integrations/sentry.md
index 120cda337..e0b23a967 100644
--- a/apps/content/docs/integrations/sentry.md
+++ b/apps/content/docs/integrations/sentry.md
@@ -36,7 +36,7 @@ bun add @orpc/otel@latest
 ```
 
 ```sh [deno]
-deno install npm:@orpc/otel@latest
+deno add npm:@orpc/otel@latest
 ```
 
 :::
diff --git a/apps/content/docs/integrations/tanstack-query-old/react.md b/apps/content/docs/integrations/tanstack-query-old/react.md
index aa62dbec2..a15df3cef 100644
--- a/apps/content/docs/integrations/tanstack-query-old/react.md
+++ b/apps/content/docs/integrations/tanstack-query-old/react.md
@@ -28,7 +28,7 @@ bun add @orpc/react-query@latest @tanstack/react-query@latest
 ```
 
 ```sh [deno]
-deno install npm:@orpc/react-query@latest npm:@tanstack/react-query@latest
+deno add npm:@orpc/react-query@latest npm:@tanstack/react-query@latest
 ```
 
 :::
diff --git a/apps/content/docs/integrations/tanstack-query-old/solid.md b/apps/content/docs/integrations/tanstack-query-old/solid.md
index c5167a04c..4486aefe5 100644
--- a/apps/content/docs/integrations/tanstack-query-old/solid.md
+++ b/apps/content/docs/integrations/tanstack-query-old/solid.md
@@ -28,7 +28,7 @@ bun add @orpc/solid-query@latest @tanstack/solid-query@latest
 ```
 
 ```sh [deno]
-deno install npm:@orpc/solid-query@latest npm:@tanstack/solid-query@latest
+deno add npm:@orpc/solid-query@latest npm:@tanstack/solid-query@latest
 ```
 
 :::
diff --git a/apps/content/docs/integrations/tanstack-query-old/svelte.md b/apps/content/docs/integrations/tanstack-query-old/svelte.md
index aacbc87c7..a99957760 100644
--- a/apps/content/docs/integrations/tanstack-query-old/svelte.md
+++ b/apps/content/docs/integrations/tanstack-query-old/svelte.md
@@ -28,7 +28,7 @@ bun add @orpc/svelte-query@latest @tanstack/svelte-query@latest
 ```
 
 ```sh [deno]
-deno install npm:@orpc/svelte-query@latest npm:@tanstack/svelte-query@latest
+deno add npm:@orpc/svelte-query@latest npm:@tanstack/svelte-query@latest
 ```
 
 :::
diff --git a/apps/content/docs/integrations/tanstack-query-old/vue.md b/apps/content/docs/integrations/tanstack-query-old/vue.md
index c51d785ee..d5c8c48cd 100644
--- a/apps/content/docs/integrations/tanstack-query-old/vue.md
+++ b/apps/content/docs/integrations/tanstack-query-old/vue.md
@@ -28,7 +28,7 @@ bun add @orpc/vue-query@latest @tanstack/vue-query@latest
 ```
 
 ```sh [deno]
-deno install npm:@orpc/vue-query@latest npm:@tanstack/vue-query@latest
+deno add npm:@orpc/vue-query@latest npm:@tanstack/vue-query@latest
 ```
 
 :::
diff --git a/apps/content/docs/integrations/tanstack-query.md b/apps/content/docs/integrations/tanstack-query.md
index 28bafd8ab..909b869cf 100644
--- a/apps/content/docs/integrations/tanstack-query.md
+++ b/apps/content/docs/integrations/tanstack-query.md
@@ -32,7 +32,7 @@ bun add @orpc/tanstack-query@latest
 ```
 
 ```sh [deno]
-deno install npm:@orpc/tanstack-query@latest
+deno add npm:@orpc/tanstack-query@latest
 ```
 
 :::
diff --git a/apps/content/docs/migrations/from-trpc.md b/apps/content/docs/migrations/from-trpc.md
index 06929e23d..221216006 100644
--- a/apps/content/docs/migrations/from-trpc.md
+++ b/apps/content/docs/migrations/from-trpc.md
@@ -59,7 +59,7 @@ bun add @orpc/server@latest @orpc/client@latest @orpc/tanstack-query@latest
 
 ```sh [deno]
 deno remove npm:@trpc/server npm:@trpc/client npm:@trpc/tanstack-react-query
-deno install npm:@orpc/server@latest npm:@orpc/client@latest npm:@orpc/tanstack-query@latest
+deno add npm:@orpc/server@latest npm:@orpc/client@latest npm:@orpc/tanstack-query@latest
 ```
 
 :::
diff --git a/apps/content/docs/openapi/client/openapi-link.md b/apps/content/docs/openapi/client/openapi-link.md
index 5037290db..e335873d7 100644
--- a/apps/content/docs/openapi/client/openapi-link.md
+++ b/apps/content/docs/openapi/client/openapi-link.md
@@ -28,7 +28,7 @@ bun add @orpc/openapi-client@latest
 ```
 
 ```sh [deno]
-deno install npm:@orpc/openapi-client@latest
+deno add npm:@orpc/openapi-client@latest
 ```
 
 :::
diff --git a/apps/content/docs/openapi/getting-started.md b/apps/content/docs/openapi/getting-started.md
index 7846876f0..c1e7f9419 100644
--- a/apps/content/docs/openapi/getting-started.md
+++ b/apps/content/docs/openapi/getting-started.md
@@ -36,7 +36,7 @@ bun add @orpc/server@latest @orpc/client@latest @orpc/openapi@latest
 ```
 
 ```sh [deno]
-deno install npm:@orpc/server@latest npm:@orpc/client@latest @orpc/openapi@latest
+deno add npm:@orpc/server@latest npm:@orpc/client@latest @orpc/openapi@latest
 ```
 
 :::
diff --git a/apps/content/docs/openapi/integrations/implement-contract-in-nest.md b/apps/content/docs/openapi/integrations/implement-contract-in-nest.md
index f2f1f3d62..2fca1608e 100644
--- a/apps/content/docs/openapi/integrations/implement-contract-in-nest.md
+++ b/apps/content/docs/openapi/integrations/implement-contract-in-nest.md
@@ -32,7 +32,7 @@ bun add @orpc/nest@latest
 ```
 
 ```sh [deno]
-deno install npm:@orpc/nest@latest
+deno add npm:@orpc/nest@latest
 ```
 
 :::
diff --git a/apps/content/docs/openapi/integrations/trpc.md b/apps/content/docs/openapi/integrations/trpc.md
index 91ff64c0d..6fc6ee5ba 100644
--- a/apps/content/docs/openapi/integrations/trpc.md
+++ b/apps/content/docs/openapi/integrations/trpc.md
@@ -28,7 +28,7 @@ bun add @orpc/trpc@latest
 ```
 
 ```sh [deno]
-deno install npm:@orpc/trpc@latest
+deno add npm:@orpc/trpc@latest
 ```
 
 :::
diff --git a/apps/content/docs/openapi/openapi-handler.md b/apps/content/docs/openapi/openapi-handler.md
index 745d57162..d9fa8c954 100644
--- a/apps/content/docs/openapi/openapi-handler.md
+++ b/apps/content/docs/openapi/openapi-handler.md
@@ -57,7 +57,7 @@ bun add @orpc/openapi@latest
 ```
 
 ```sh [deno]
-deno install npm:@orpc/openapi@latest
+deno add npm:@orpc/openapi@latest
 ```
 
 :::
diff --git a/apps/content/docs/openapi/openapi-specification.md b/apps/content/docs/openapi/openapi-specification.md
index da41d5373..d3cd0261f 100644
--- a/apps/content/docs/openapi/openapi-specification.md
+++ b/apps/content/docs/openapi/openapi-specification.md
@@ -28,7 +28,7 @@ bun add @orpc/openapi@latest
 ```
 
 ```sh [deno]
-deno install npm:@orpc/openapi@latest
+deno add npm:@orpc/openapi@latest
 ```
 
 :::
diff --git a/apps/content/docs/openapi/plugins/smart-coercion.md b/apps/content/docs/openapi/plugins/smart-coercion.md
index 16cee3b62..3c2d78918 100644
--- a/apps/content/docs/openapi/plugins/smart-coercion.md
+++ b/apps/content/docs/openapi/plugins/smart-coercion.md
@@ -32,7 +32,7 @@ bun add @orpc/json-schema@latest
 ```
 
 ```sh [deno]
-deno install npm:@orpc/json-schema@latest
+deno add npm:@orpc/json-schema@latest
 ```
 
 :::
diff --git a/apps/content/docs/openapi/plugins/zod-smart-coercion.md b/apps/content/docs/openapi/plugins/zod-smart-coercion.md
index f3b1ee305..575c3c20b 100644
--- a/apps/content/docs/openapi/plugins/zod-smart-coercion.md
+++ b/apps/content/docs/openapi/plugins/zod-smart-coercion.md
@@ -32,7 +32,7 @@ bun add @orpc/zod@latest
 ```
 
 ```sh [deno]
-deno install npm:@orpc/zod@latest
+deno add npm:@orpc/zod@latest
 ```
 
 :::
diff --git a/apps/content/docs/server-action.md b/apps/content/docs/server-action.md
index f4c5efbf8..7643c6a9c 100644
--- a/apps/content/docs/server-action.md
+++ b/apps/content/docs/server-action.md
@@ -125,7 +125,7 @@ bun add @orpc/react@latest
 ```
 
 ```sh [deno]
-deno install npm:@orpc/react@latest
+deno add npm:@orpc/react@latest
 ```
 
 :::

From cca22e492826ead9da693a22a336bcab62596156 Mon Sep 17 00:00:00 2001
From: unnoq <contact@unnoq.com>
Date: Tue, 26 Aug 2025 14:30:41 +0700
Subject: [PATCH 4/4] fix

---
 apps/content/docs/openapi/getting-started.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/apps/content/docs/openapi/getting-started.md b/apps/content/docs/openapi/getting-started.md
index c1e7f9419..80c0b612d 100644
--- a/apps/content/docs/openapi/getting-started.md
+++ b/apps/content/docs/openapi/getting-started.md
@@ -36,7 +36,7 @@ bun add @orpc/server@latest @orpc/client@latest @orpc/openapi@latest
 ```
 
 ```sh [deno]
-deno add npm:@orpc/server@latest npm:@orpc/client@latest @orpc/openapi@latest
+deno add npm:@orpc/server@latest npm:@orpc/client@latest npm:@orpc/openapi@latest
 ```
 
 :::