curveballjs.org

What It Is

Curveball is a micro HTTP framework for TypeScript. It can be positioned alongside Express, Koa, and Fastify, but the documentation clearly emphasizes that it is better suited for building APIs. It follows a “small core + optional plugins” approach and is used via npm packages. The examples show modules such as @curveball/core, @curveball/kernel, @curveball/aws-lambda, controllers, and routers.

Core Capabilities

At the core of Curveball is its middleware model: all logic can be middleware, with async support. Compared with the traditional approach of writing socket responses directly, Curveball allows middleware to transform the response body after request handling is complete. For example, it can automatically convert JSON into HTML based on Accept: text/html, which is valuable for API debugging, content negotiation, and response rewriting. It also provides resource-oriented Controllers, recommending that one Controller manage one type of resource or one route, with dispatching by HTTP method and Accept type.

In terms of HTTP features, Curveball goes fairly deep: HTTP/2 Push, Content Negotiation, 1xx informational responses, the Prefer header, Link header, and RFC7807 application/problem+json error responses are all mentioned in the documentation. Official middleware includes access logging, Body Parser, CORS, OAuth2, Session, Session-Redis, Static, Validator, Links, and API Browser, making it suitable for building REST-style APIs.

Runtime, Deployment, and Pricing

Curveball supports Node, Bun, AWS Lambda, and Azure Functions. The documentation specifically notes that its minimal kernel allows it to run natively on AWS Lambda and Bun, rather than depending on a heavy compatibility layer. In terms of pricing, the page does not show any commercial plans or paid editions, only npm installation instructions. Whether it is open source is not explicitly stated in the reviewed text.

Pros, Cons, and Best-Fit Users

Its strengths include solid support for modern HTTP features, good Serverless compatibility, official middleware that covers common API needs, and clear TypeScript examples. Its downsides are that the documentation explicitly assumes readers already understand HTTP requests/responses and TypeScript, so it is not ideal as a beginner-friendly web development framework. In addition, the documentation acknowledges that performance issues for large files caused by response-body buffering are “not solved yet.” Information about ecosystem size, community activity, and commercial support is also limited.

Access from China and Alternatives

The reviewed text does not provide information about access from mainland China. Domain and npm package availability would need to be tested in practice, so this is currently marked as unknown. Payment information is also unavailable. If your team prioritizes a mature ecosystem, Express, Koa, or Fastify may be worth evaluating. If your project emphasizes REST, content negotiation, and HTTP semantics such as Link and Prefer headers, Curveball deserves closer attention.