Routup is a minimalistic, runtime-agnostic HTTP routing framework for Node.js, Bun, Deno, and Cloudflare Workers. Handlers return values directly — routup converts them to Web Response objects automatically.

Table of Contents

• Installation
• Features
• Documentation
• Usage
• Templates
• Plugins
• Comparison
• Contributing
• License

npm install routup --save

• 🚀 Runtime agnostic — Node.js, Bun, Deno, Cloudflare Workers
• 🌐 Web-standard APIs — built on Request / Response for portability
• 📝 Return-based handlers — return strings, objects, streams, or Response directly
• ✨ Async middleware — onion model with event.next()
• 📌 Lifecycle hooks — request, response, error for cross-cutting concerns
• 🔌 Plugin system — extend with reusable, installable plugins
• 🧰 Tree-shakeable helpers — import only what you use
• 📁 Nestable routers — modular route composition
• 👕 TypeScript first — fully typed API with generics
• 🤏 Minimal footprint — small core, no bloat

To read the docs, visit https://routup.net

Handlers receive an event and return a value. Routup converts the return value to a Web Response automatically.

Shorthand

import { Router, defineCoreHandler, defineErrorHandler, serve } from 'routup';

const router = new Router();

router.get('/', defineCoreHandler(() => 'Hello, World!'));
router.get('/greet/:name', defineCoreHandler((event) => `Hello, ${event.params.name}!`));
router.use(defineErrorHandler((error) => ({ error: error.message })));

serve(router, { port: 3000 });

Verbose

import { Router, defineCoreHandler, serve } from 'routup';

const router = new Router();

router.use(defineCoreHandler({
    path: '/',
    method: 'GET',
    fn: () => 'Hello, World!',
}));

router.use(defineCoreHandler({
    path: '/greet/:name',
    method: 'GET',
    fn: (event) => `Hello, ${event.params.name}!`,
}));

serve(router, { port: 3000 });

Middleware calls event.next() to continue the pipeline:

router.use(defineCoreHandler(async (event) => {
    console.log(`${event.method} ${event.path}`);
    return event.next();
}));

Routup runs on Node.js, Bun, Deno, and Cloudflare Workers. In most cases, import from routup:

import { Router, defineCoreHandler, serve } from 'routup';

const router = new Router();
router.get('/', defineCoreHandler(() => 'Hello, World!'));
serve(router, { port: 3000 });

For runtime-specific APIs (e.g. toNodeHandler), use the corresponding entrypoint like routup/node.

Scaffold a new project from any starter in routup/templates with degit:

npx degit routup/templates/node-api my-app

Routup is minimalistic by design. Plugins extend the framework with additional functionality.

How routup stacks up against other popular Node.js routing frameworks. This is a best-effort summary; check each project's docs for the full picture.

Recorded with routup v5.1 on Node.js 24, May 2026. autocannon -c 100 -d 40 -p 10 (40s warm-up, 40s measure).

Routup currently trails on raw req/s for the trivial GET / case — the focus of v5 has been runtime portability and ergonomics rather than micro-optimization. Throughput is competitive with express. To re-run the suite yourself, see the benchmarks repository.

Before starting to work on a pull request, it is important to review the guidelines for contributing and the code of conduct. These guidelines will help to ensure that contributions are made effectively and are accepted.

Made with 💚

Published under MIT License.