Deploy with Bun

Bun provides ultra-fast startup and execution. Deploy your Stoma gateway with Bun for maximum performance.

Quick Start

Install dependencies
Terminal window
```
bun install hono @homegrower-club/stoma
```

Create your gateway

For a minimal example, see the Basic Gateway partial. Here’s a typical production setup with the Bun adapter:

import {
  createGateway,
  cors,
  requestLog,
  rateLimit,
} from "@homegrower-club/stoma";
import { bunAdapter } from "@homegrower-club/stoma/adapters/bun";

const gateway = createGateway(
  {
    name: "my-gateway",
    basePath: "/api",
    policies: [requestLog(), cors()],
    routes: [
      {
        path: "/users/*",
        pipeline: {
          policies: [rateLimit({ max: 100, window: 60 })],
          upstream: {
            type: "url",
            target: "https://api.example.com",
            rewritePath: (path) => path.replace("/api", ""),
          },
        },
      },
    ],
  },
  // Production adapter with rate limiting and caching support
  bunAdapter()
);

export default gateway.app;

Create the server entry

import gateway from "./index";

Bun.serve({
  fetch: gateway.fetch,
  port: parseInt(process.env.PORT || "3000"),
});

console.log("Gateway running on http://localhost:3000");

Run
Terminal window
```
bun run src/server.ts
```

Bun Adapter

Use the Bun adapter for production deployments:

import {
  createGateway,
  cors,
  rateLimit,
  cache,
} from "@homegrower-club/stoma";
import { bunAdapter } from "@homegrower-club/stoma/adapters/bun";

const adapter = bunAdapter();

const gateway = createGateway({
  name: "my-gateway",
  basePath: "/api",
  adapter,
  policies: [cors()],
  routes: [
    {
      path: "/users/*",
      pipeline: {
        policies: [
          rateLimit({
            max: 100,
            windowSeconds: 60,
            store: adapter.rateLimitStore,
          }),
        ],
        upstream: {
          type: "url",
          target: "https://api.example.com",
        },
      },
    },
  ],
});

export default gateway.app;

Bun Serve Options

Basic Server

import gateway from "./index";

const server = Bun.serve({
  fetch: gateway.fetch,
  port: 3000,
});

console.log(`Listening on http://localhost:${server.port}`);

With TLS/HTTPS

import gateway from "./index";

const server = Bun.serve({
  fetch: gateway.fetch,
  port: 443,
  tls: {
    cert: Bun.file("./cert.pem"),
    key: Bun.file("./key.pem"),
  },
});

With Unix Socket

For reverse proxy integration (nginx, Caddy):

import gateway from "./index";

Bun.serve({
  fetch: gateway.fetch,
  unix: "/tmp/gateway.sock",
});

Platform Deployment

Railway

[build]
builder = "bun"

[deploy]
startCommand = "bun run src/server.ts"

Or use package.json:

{
  "scripts": {
    "start": "bun run src/server.ts"
  }
}

Render

services:
  - type: runtime
    runtime: bun
    buildCommand: bun install
    startCommand: bun run src/server.ts
    envVars:
      - key: NODE_ENV
        value: production

Fly.io

app = "stoma-gateway"

[build]
  builder = "ghcr.io/oven-sh/bun-docker"

[[vm]]
  cpuKind = "shared"
  cpus = 1
  memoryMB = 256

Deno Deploy

If using Deno Deploy, you can run Bun-compiled code or use Deno:

import gateway from "./index";

Deno.serve(gateway.app.fetch);

Bun Performance Tips

Use Bun’s built-in HTTP server (not Node.js compatibility mode)
Leverage Bun’s native TypeScript support - no transpilation needed
Use --bun flag when running TypeScript directly:

bun --bun src/index.ts

Environment Variables

const gateway = createGateway({
  name: process.env.GATEWAY_NAME || "my-gateway",
  basePath: process.env.BASE_PATH || "/api",
  debug: process.env.DEBUG === "true",
});

GATEWAY_NAME=my-gateway
PORT=3000
DEBUG=false

Performance Comparison

Runtime	Cold Start	Request/Second
Node.js	~200ms	~10k
Bun	~30ms	~50k
Cloudflare Workers	~5ms	~15k