| description | Void route handlers run on Hono. Add hono to your app when your code imports from it directly. |
|---|---|
| outline | deep |
Void handlers run on Hono. Void depends on Hono internally, but if your app imports from hono/* directly, add hono to your app's dependencies first.
npm install honoOnce hono is installed in your app, you can use built-in middleware, helpers, and third-party Hono packages directly.
Use Hono's built-in middleware in your global middleware files or per-route:
// middleware/01.cors.ts
import { cors } from 'hono/cors';
import { defineMiddleware } from 'void';
export default defineMiddleware(cors({ origin: 'https://example.com' }));// routes/api/products.ts (per-route cache)
import { cache } from 'hono/cache';
import { defineHandler } from 'void';
import { listProducts } from '../../lib/products';
export const GET = defineHandler(
cache({ cacheName: 'products', cacheControl: 'max-age=3600' }),
async () => ({ products: await listProducts() }),
);::: warning
cache() stores one response per URL and returns it to every visitor. It skips requests with an Authorization header, but not cookies. Use it only on routes whose response is the same for everyone, never on a route that reads the signed-in user. To cache pages, use revalidation, which skips requests that carry a cookie.
:::
// routes/api/webhooks/stripe.ts (per-route usage)
import { bearerAuth } from 'hono/bearer-auth';
import { defineHandler } from 'void';
export const POST = defineHandler(bearerAuth({ token: 'webhook-secret' }), async (c) => {
const body = await c.req.json();
return { received: true };
});Hono's context helpers are available on c in every handler:
// routes/api/download.ts
import { stream } from 'hono/streaming';
import { defineHandler } from 'void';
export const GET = defineHandler((c) => {
return stream(c, async (stream) => {
await stream.write('chunk 1');
await stream.write('chunk 2');
});
});// routes/api/data.ts
import { defineHandler } from 'void';
export const GET = defineHandler((c) => {
c.header('X-Custom', 'value');
c.status(201);
return c.json({ created: true });
});Any hono/* or @hono/* package works. Install the package in your app, then use it directly:
// middleware/01.rate-limit.ts
import { rateLimiter } from 'hono-rate-limiter';
import { defineMiddleware } from 'void';
export default defineMiddleware(rateLimiter({ windowMs: 60_000, limit: 100 }));Hono's standalone helpers work anywhere:
import { HTTPException } from 'hono/http-exception';
throw new HTTPException(404, { message: 'User not found' });For the full list of built-in middleware, see the Hono documentation.
Return c.redirect() from a handler to send the visitor to another URL. If a helper needs to stop the handler, throw an HTTPException with the redirect response in res:
// lib/require-page-user.ts
import { HTTPException } from 'hono/http-exception';
import type { CloudContext } from 'void';
import { getUser } from 'void/auth';
export function requirePageUser(c: CloudContext) {
const user = getUser();
if (!user) {
throw new HTTPException(302, { res: c.redirect('/login') });
}
return user;
}This works in loaders, actions, and middleware, including client-side page navigation. For a redirect after a mutation, use new HTTPException(303, { res: c.redirect('/login', 303) }) so the next request is a GET.
For a sign-in check like this one, requireAuth(c, { throwRedirect: '/login' }) provides the same guard and selects the redirect status for you.