Skip to main content
ff-serv is a lightweight HTTP server utilities package built on Effect.ts. It provides composable handlers, built-in caching with SWR (stale-while-revalidate), logging, and integrations for modern web frameworks.

​
Features

  • Composable HTTP Handlers: Build request handlers with Effect-based composition
  • oRPC Integration: First-class support for @orpc/server
  • Advanced Caching: In-memory cache with SWR and pluggable Redis adapters
  • Effect.ts Native: Fully integrated with Effect’s type-safe error handling and context management
  • TypeScript-First: Complete type safety with inference
  • CLI Tools: Database utilities for pulling and dumping PostgreSQL databases

​
Installation

bun add ff-serv effect

​
Peer Dependencies

Depending on your use case, you may need: 
# For oRPC integration
bun add @orpc/server

# For port utilities
bun add get-port

# For OpenTelemetry
bun add @effect/opentelemetry

# For Redis caching (optional)
bun add ioredis

​
Package Exports

ff-serv provides multiple entry points: 
// Main exports
import { createFetchHandler, basicHandler, Logger, getPort } from 'ff-serv'

// oRPC integration
import { oRPCHandler } from 'ff-serv/orpc'

// Cache utilities
import { Cache, CacheAdapter } from 'ff-serv/cache'

// Redis adapters
import { ioredis } from 'ff-serv/cache/ioredis'
import { bunRedis } from 'ff-serv/cache/bun-redis'

​
Quick Start

Here’s a minimal HTTP server with Effect.ts: 
import { createFetchHandler, basicHandler } from 'ff-serv'
import { Effect } from 'effect'

const program = Effect.gen(function* () {
  const fetch = yield* createFetchHandler([
    basicHandler('/health', () => new Response('OK')),
  ])

  Bun.serve({
    port: 3000,
    fetch,
  })

  yield* Effect.log('Server running on http://localhost:3000')
})

Effect.runPromise(program)

​
What’s Next?

Basic Server

Learn how to create HTTP handlers

Fetch Handler

Compose handlers with createFetchHandler

Cache

Add caching with SWR support

CLI

Database utilities and CLI tools

Build docs developers (and LLMs) love

Get started for freeTalk to us