Deploying to Vercel

Your Next.js project should have the following structure:

• src/app/api/rivet/[...all]/route.ts: RivetKit route handler
• src/actors.ts: Actor definitions and registry

See the Next.js quickstart or the Next.js template to get started.

Your Hono project needs:

1. A vercel.json file with the Hono framework specified:

{
  "framework": "hono"
}

2. Your server file must import from "hono" for Vercel to recognize the framework:

// You MUST import from "hono" for Vercel to detect this as a Hono app
import { Hono } from "hono";
import { registry } from "./actors.ts";

const app = new Hono();
app.all("/api/rivet/*", (c) => registry.handler(c.req.raw));
export default app;

3. Use .ts file extensions in imports and configure your tsconfig.json:

{
  "compilerOptions": {
    "allowImportingTsExtensions": true,
    "rewriteRelativeImportExtensions": true
  }
}

See the Hello World template for a complete example.

For more details on Hono deployments, see Vercel’s Hono documentation.

Vercel currently supports Next.js and Hono frameworks for RivetKit deployments.

For other frameworks, consider deploying to Railway, Kubernetes, or another platform.