Frameworks - Corsair

Corsair mounts one route. It serves Hub delivery — OAuth callbacks, connect pages, self-registration — and the management API in the same place. Every adapter wraps a single primitive, managementHandler(corsair), which returns a (request: Request) => Promise<Response>. Pick the tab for your server; the rest of your app is identical.

Configure Corsair

corsair.ts

import { createCorsair } from 'corsair';
import { github } from '@corsair-dev/github';

export const corsair = createCorsair({
    plugins: [github({ authType: 'managed' })],
    database: db,
    kek: process.env.CORSAIR_KEK!,
    hub: {
        projectApiKey: process.env.CORSAIR_DEV_API_KEY!,
        signingSecret: process.env.CORSAIR_DEV_SIGNING_SECRET!,
    },
});

Mount the route

Next.js
Express
Hono
Web-standard

app/api/corsair/[[...path]]/route.ts

import { toNextJsHandler } from 'corsair';
import { corsair } from '@/server/corsair';

export const { GET, POST, OPTIONS } = toNextJsHandler(corsair, {
    basePath: '/api/corsair',
});

Pages Router? Export a catch-all API route at pages/api/corsair/[...path].ts and forward req/res through the same toNextJsHandler. The App Router is the supported default.

server.ts

import express from 'express';
import { toExpressHandler } from 'corsair';
import { corsair } from './corsair';

const app = express();

// Required: Hub delivers results as JSON POSTs. The adapter reads the parsed
// body, so express.json() must run before the Corsair route.
app.use(express.json());
app.use('/api/corsair', toExpressHandler(corsair, { basePath: '/api/corsair' }));

app.listen(3000);

Mount express.json() before the Corsair route. Without it, req.body is undefined and Hub’s delivery POSTs arrive empty — connects will look like they hang.

index.ts

import { Hono } from 'hono';
import { toHonoHandler } from 'corsair';
import { corsair } from './corsair';

const app = new Hono();

// Wildcard: Corsair routes several paths under the base (delivery, connect,
// tenants). Match them all with `/*`, and keep basePath in sync with the mount.
app.all('/api/corsair/*', toHonoHandler(corsair, { basePath: '/api/corsair' }));

export default app;

Every adapter wraps one primitive: managementHandler(corsair) returns (request: Request) => Promise<Response>. Any framework whose routes speak the Fetch API calls it directly — no adapter needed.

// src/routes/api/corsair/[...path]/+server.ts
import { managementHandler } from 'corsair';
import { corsair } from '$lib/server/corsair';

const handler = managementHandler(corsair, { basePath: '/api/corsair' });
export const GET = ({ request }) => handler(request);
export const POST = ({ request }) => handler(request);

// app/routes/api.corsair.$.ts
import { managementHandler } from 'corsair';
import { corsair } from '~/server/corsair';

const handler = managementHandler(corsair, { basePath: '/api/corsair' });
export const loader = ({ request }) => handler(request);
export const action = ({ request }) => handler(request);

// src/pages/api/corsair/[...path].ts
import { managementHandler } from 'corsair';
import { corsair } from '../../../server/corsair';

const handler = managementHandler(corsair, { basePath: '/api/corsair' });
export const GET = ({ request }) => handler(request);
export const POST = ({ request }) => handler(request);
export const prerender = false;

// server/routes/api/corsair/[...path].ts
import { fromWebHandler } from 'h3';
import { managementHandler } from 'corsair';
import { corsair } from '~/server/corsair';

// h3's fromWebHandler adapts the (Request) => Response handler to Nitro.
export default fromWebHandler(
    managementHandler(corsair, { basePath: '/api/corsair' }),
);

import { managementHandler } from 'corsair';
import { corsair } from './corsair';

const handler = managementHandler(corsair, { basePath: '/api/corsair' });
export default { fetch: (request: Request) => handler(request) };

Backend not in JavaScript? Corsair’s SDK is TypeScript-only. Integrate over the Hub REST API instead.

Run and go green

Start your dev server and make one request to /api/corsair. On that first request your app self-registers its delivery URL with Hub and the dashboard header dot turns green. See Delivery URLs. Stays grey? The route isn’t reachable at /api/corsair. Check the mount path and — on Express and Hono — that basePath and the wildcard (/api/corsair/*) match the path you mounted.

What’s next

Hub setup

Create a project, copy keys, reach the green check.

Add a plugin

Browse the catalog — GitHub, Slack, Linear, and hundreds more.

Vanilla client

Call the management API from any JS runtime.

React hooks

Typed useTenants, useConnectionStatus, and friends.

​Configure Corsair

​Mount the route

​Run and go green

​What’s next

Hub setup

Add a plugin

Vanilla client

React hooks

Configure Corsair

Mount the route

Run and go green

What’s next