Getting Started

Quick Start (CLI)

Create a server entry:

export default {
  fetch(req: Request) {
    return Response.json({ hello: "world!" });
  },
};

Then, run the server using your favorite runtime:

npx srvx

pnpx srvx

yarn dlx srvx

deno -A npm:srvx

bunx --bun srvx

Quick Start (API)

Instead of using the srvx CLI, you can directly import the serve method to define a self-listening server entry.

Create a server entry:

import { serve } from "srvx";

const server = serve({
  fetch(request) {
    return Response.json({ hello: "world!" });
  },
});

Install srvx as a dependency:

npm i srvx

yarn add srvx

pnpm i srvx

bun i srvx

deno i npm:srvx

Then, run the server using your favorite runtime:

node server.mjs

deno run --allow-env --allow-net server.mjs

bun run server.mjs

TypeScript

srvx ships one shared set of type definitions covering every supported runtime. The runtime types they reference come from ambient type packages, declared as optional peerDependencies so that nothing is installed unless you ask for it:

Starter Examples