tinyhttp

⚡ Tiny web framework as a replacement of Express

[][site-url] [][npm-url] [][github-actions] [][codecov] [][codacy-url] [][gh-url] [][license]

🦕 tinyhttp now has a Deno port (work in progress)

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:

• ⚡ 2x 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

Visit tinyhttp website for docs, guides and middleware search.

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

Create a new project using tinyhttp CLI:

pnpm i -g @tinyhttp/cli

tinyhttp new basic my-app

cd my-app

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)

See tinyhttp "Learn" page for complete guide.

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

See COMPARISON.md.

Benchmarks

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 💻 📖	MVEMCJSUNPE 💡 🐛	Leo Toneff 💻
Calum Knott 📖 🐛	Reinaldy Rafli 💻