Itty-router NPM | npm.io

5.0.17 • Published 7 days ago

Install

Weekly downloads

1,113

License

MIT

Repository

Last release

7 days ago

v5 Documentation | v4 -> v5 Migration Guide | Discord

An ultra-tiny API microrouter, for use when size matters (e.g. Cloudflare Workers).

Features

Tiny. Routers from ~450 bytes to a ~970 bytes batteries-included version (~240-500x smaller than Express.js).
TypeScript. Powerfully (and flexibly) typed for any environment.
Route-parsing & query parsing.
Middleware. Use ours or write your own.
100% Test Coverage. Bulletproof for production peace-of-mind.
Designed specifically for serverless (but works anywhere).
No assumptions. Return anything; pass in anything.
Future-proof. HTTP methods not-yet-invented already work with it.

Example

import { AutoRouter } from 'itty-router' // ~1kB

const router = AutoRouter()

router
  .get('/hello/:name', ({ name }) => `Hello, ${name}!`)
  .get('/json', () => [1,2,3])
  .get('/promises', () => Promise.resolve('foo'))

export default router

// that's it ^-^

Need Help?

Complete API documentation is available on itty.dev, or join our Discord channel to chat with community members for quick help!

Join the Discussion!

Have a question? Suggestion? Idea? Complaint? Want to send a gift basket? Join us on Discord!

A Special Thanks :heart:

As the community and contributor list has grown (and thus an individualized list here is no longer easily maintainable), I'd like to thank each and every one of you for making itty far greater than its humble origins. The robustness you see today, the careful consideration of every byte spent on features, the API choices, the code-golfing itself... are all thanks to the efforts and feedback from the community. I'd especially like to thank the core contributors and PR-authors, as well as the fantastic folks on the itty Discord group, for their tireless work refining this little beast and answering community questions.

api router cloudflare workers worker serverless cors middleware rest serviceworker nested

summertyme @rameardo/cfw-framework @everything-registry/sub-chunk-1942 cloudflare-dtty ens-metadata-service grouper-web fuzd-cf-worker durable-apis dtty dtty-extra edge-api farms-api feathers-cf-durable feathers-cf-kv feathers-cf-rest hiking_trail_worker leetcode-card mailsend konsum-cloudflare-worker kukri nihilet partyrpc paste-story-server payments.s2maps.io rayous react-lazy-ssr-workers r2-repository r2-explorer test-wrangler ts-entangler shopify-cloudflare-workers-webhooks-app sidra snext voluptatemodio worker-typescript-template @ts-rest/serverless @types/itty-router-extras @zalastax/nolb-itt apis.do @anywhichway/lazui @autotelic/worker-request-handlers @vontage/types atomic-url @vercaemer/sandbox @vercaemer/worker-router @discordcf/framework cloudflare-discord-bot cloudflare-gdrive cloudflare-kv-store @devdayo/reactr @ensdomains/ccip-read-cf-worker @codeeditorland/ingress crossbuild @cyancy/cf-responder directomatic dishttp do-counter-sharding @eventual/core @eventual/core-runtime @eventual/runtime-core @fermyon/spin-sdk chainlink-fullstack-api @cloudflare/itty-router-openapi @cheqd/auth0-service @cheqd/secret-box-service cf-discord-bot cf-discord-js @muzamint/erica @mytiki/worker-utils-ts @neko03/with-interaction @latticexyz/persona-mint @konsumation/cloudflare-worker @metaplayerone/offchain-read-mp1-worker @presta/adapter-cloudflare-workers @spectera/framework @ticketbridge/hyper-durable

7 days ago

16 days ago

21 days ago

21 days ago

21 days ago

27 days ago

27 days ago

26 days ago

26 days ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

1 month ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

4 months ago

4 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

8 months ago

8 months ago

8 months ago

8 months ago

9 months ago

9 months ago

12 months ago

12 months ago

12 months ago

12 months ago

12 months ago

11 months ago

11 months ago

11 months ago

11 months ago

12 months ago

12 months ago

11 months ago

12 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

9 months ago

9 months ago

11 months ago

9 months ago

9 months ago

9 months ago

9 months ago

11 months ago

11 months ago

10 months ago

11 months ago

9 months ago

9 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago

4 years ago