Integrations

Introduction

oRPC is design with Fetch API in mind, so you can use it in any modern environment and framework.

import { createFetchHandler } from '@orpc/server/fetch'
import { serve } from 'srvx'
import { router } from 'examples/server'
 
const handler = createFetchHandler({
  router,
  serverless: false, // set true will improve cold start times
})
 
 
const server = serve({
  fetch(request) {
    return handler({
      request,
      context: {},
      prefix: '/api',
    })
  },
  port: 2206,
})
 
await server.ready()
 
// biome-ignore lint/suspicious/noConsole: <explanation>
console.log(`🚀 Server ready at ${server.url}`)

Under the hood, oRPC utilizes the RegExpRouter from Hono (the fastest router in the JavaScript ecosystem). We also provide first-class support for Edge and serverless environments.

Hono

While oRPC uses Hono's routing engine internally, there are additional benefits to using oRPC with Hono directly.

import { Hono } from 'hono'
import { createFetchHandler } from '@orpc/server/fetch'
import { router } from 'examples/server'
 
// For performance, create a global router handler
const handler = createFetchHandler({
  router,
  serverless: false, // Set to true to improve cold start times
})
 
const app = new Hono()
 
app.get('/api/*', (c) => {
  return handler({
    request: c.req.raw,
    prefix: '/api',
    context: {},
  }) 
})
 
export default app

Next.JS

As of Next.js 13, you can use the Fetch API for route handlers.

app/api/[[...orpc]].ts

import { createFetchHandler } from '@orpc/server/fetch'
import { router } from 'examples/server'
 
// For performance, create a global router handler
const handler = createFetchHandler({
  router,
  serverless: false, // Set to true to improve cold start times
})
 
const fetchRequestHandler = async (request: Request) => {
  return handler({
    request,
    prefix: '/api',
    context: {},
  }) 
}
 
export const GET = fetchRequestHandler
export const POST = fetchRequestHandler
export const PUT = fetchRequestHandler
export const DELETE = fetchRequestHandler
export const PATCH = fetchRequestHandler

Cloudflare Worker

Cloudflare Workers support Fetch API out of the box.

import { createFetchHandler } from '@orpc/server/fetch'
import { router } from 'examples/server'
 
// For performance, create a global router handler
const handler = createFetchHandler({
  router,
  serverless: true, // Set to true to improve cold start times
})
 
export default {
  async fetch(request: Request) {
    return handler({
      request,
      prefix: '/',
      context: {},
    })
  },
}

Other Environments and Frameworks

Since most modern environments and frameworks support the Fetch API, you can use oRPC with virtually any environment or framework.