Arbor

A minimal, modular Node.js framework for building fast, predictable web applications.

Arbor gives you explicit control over your application: no hidden behaviors, no heavy abstractions and no configuration files posing as code.
Branches shape your URL space, routes define entry points and actions execute your logic in a simple, predictable chain. If you understand the request bundle and the flow of actions, you understand Arbor.

Installation

npm i @kequtech/arbor

Requires Node 20+.

Quick Start

A minimal Arbor app:

import { createApp, createRoute } from "@kequtech/arbor";

const routeHello = createRoute({
  method: "GET",
  url: "/",
  actions: [
    () => "Hello, Arbor!",
  ],
});

export default createApp({
  routes: [routeHello],
});

Run with any HTTP server that can accept a Node request listener:

import { createServer } from "node:http";
import app from "./app.ts";

createServer(app).listen(3000);

Open: http://localhost:3000 → Hello, Arbor!

Documentation

Full documentation is available at:

https://docs.kequtech.com/arbor/

It includes:

• Core concepts (branches, routes, actions, body parsing, renderers, errors)
• Guides for authentication, validation, testing and project structure
• Detailed specifications for getBody, Ex, staticDirectory, sendFile and more

Philosophy

Arbor is intentionally small:

• No magic
• No global configuration layers
• No hidden middleware chains
• No nested abstractions you must memorize

Everything is explicit, composable and easy to trace.

Contributing

Issues and pull requests are welcome. Arbor evolves pragmatically and contributions that preserve its clarity and simplicity are especially appreciated.

License

ISC © Kequtech Innovations Kft.