tinyhttp

⚡ Tiny web framework as a replacement of Express

tinyhttp is a modern Express-like web framework written in TypeScript and compiled to native ESM, that uses a bare minimum amount of dependencies trying to avoid legacy hell.

Here is a short list of most important features that tinyhttp has:

⚡ 2.3x faster than Express
⚙ Full Express middleware support
↪ Async middleware support
☑ Native ESM and CommonJS support
🚀 No legacy dependencies, just the JavaScript itself
🔨 Types out of the box
🔥 Prebuilt middleware for modern Node.js

To get started, visit tinyhttp website.

Install

tinyhttp requires Node.js 12.4.0 or newer. It is recommended to use pnpm, although it isn't required.

# npm
npm i @tinyhttp/app
# pnpm
pnpm i @tinyhttp/app
# yarn
yarn add @tinyhttp/app

Docs

You can see the documentation here.

Get Started

tinyhttp is compiled to ESM (and legacy CommonJS) so you can use import / export syntax in Node.js with it.

To setup a Node ESM package, put "type": "module" in the package.json file, like this:

{
  "type": "module"
}

Another option would be using an .mjs extension, then you don't need to put that "type" field in package.json.

For more info, check out the ECMAScript Modules Node.js documentation.

From now on you can use named imports for ESM modules and default imports for CommonJS modules in your project.

The app structure is quite similar to Express, except that you need to import App from @tinyhttp/app instead of default import from express.

import { App } from '@tinyhttp/app'
import { logger } from '@tinyhttp/logger'

const app = new App()

app
  .use(logger())
  .use(function someMiddleware(req, res, next) {
    console.log('Did a request')
    next()
  })
  .get('/', (_, res) => {
    res.send('<h1>Hello World</h1>')
  })
  .get('/page/:page/', (req, res) => {
    res.status(200).send(`You just opened ${req.params.page}`)
  })
  .listen(3000)

For more examples, check examples folder.

Middlewares

tinyhttp offers a list of premade middleware for common tasks, such as session, logger and jwt.

Search and explore the full list at middleware search page.

Comparison

To compare tinyhttp with Express and Polka (another Express-like framework), see COMPARISON.md

Benchmarks

To see benchmark comparison between tinyhttp, polka, express and koa, check benchmark folder.

Contributing

See CONTRIBUTING.md.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

_{v 1 r t l} 💡 🔌 📆 🚧 💻	_Matt 🔌 ⚠️	_Nasmevka 📖	_elianiva 💡 🚧 💻 ⚠️	_{Katja Lutz} 💡	_Arnovsky 🔌 💻	_{Rocktim Saikia} 🚇 💻 💡
_{Ahmad Reza} 💻	_{Ionel lupu} 💡	_{Tomi Kalmi} 📖	_Luiginator 💡 💻	_{Aneesh Relan} 💡 ⚠️	_{Roberto Ortega} 💡	_{Barciet Maëlann} 💡
_shzmr 💻 ⚠️ 💡	_{Egor Avakumov} 💡	_{Rashmi K A} 💻	_{Shubhi Agarwal} ⚠️	_Maurizio ⚠️ 💻	_jkreller 💡	_{Alan Carpilovsky} ⚠️
_KoljaTM ⚠️	_ike 📖 💡	_{Fabian Morón Zirfas} 🐛	_{Vitaly Baev} ⚠️ 🐛	_omrilotan 💻