Skip to content
master
Switch branches/tags
Code

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
Dec 14, 2020
Jun 18, 2020

tinyhttp

⚑ Tiny web framework as a replacement of Express

npm GitHub Workflow Status Codecov Vulnerabilities Codacy grade Last commit NPM

πŸ¦• 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

See global framework benchmark.

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

πŸ’» πŸ›

Ganesh Pendyala

πŸ“–

Maxim

πŸ›

wasd845

πŸ›

This project follows the all-contributors specification. Contributions of any kind welcome!

Sponsors πŸ’°


Deta

molefrog

Carrots

Donate

The best way to support the project is to stake it on DEV. Note that you also get rewarded by staking, as well as the project author.

DEV

PayPal ko-fi Qiwi Yandex Money

Bitcoin Ethereum

License

MIT Β© v1rtl