0
0
mirror of https://github.com/honojs/hono.git synced 2024-11-21 18:18:57 +01:00
hono/README.md

93 lines
3.7 KiB
Markdown
Raw Normal View History

<div align="center">
<a href="https://hono.dev">
<img src="https://raw.githubusercontent.com/honojs/hono/main/docs/images/hono-title.png" width="500" height="auto" alt="Hono"/>
</a>
</div>
<hr />
2021-12-14 21:17:56 +01:00
<p align="center">
<a href="https://hono.dev"><b>Documentation 👉 hono.dev</b></a><br />
<i>Now supports <a href="https://jsr.io/@hono/hono">JSR</a> and <code>deno.land/x</code> is deprecated! See <a href="docs/MIGRATION.md">Migration guide</a>.</i>
</p>
<hr />
[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/honojs/hono/ci.yml?branch=main)](https://github.com/honojs/hono/actions)
[![GitHub](https://img.shields.io/github/license/honojs/hono)](https://github.com/honojs/hono/blob/main/LICENSE)
2022-02-21 16:01:31 +01:00
[![npm](https://img.shields.io/npm/v/hono)](https://www.npmjs.com/package/hono)
2022-02-23 03:20:29 +01:00
[![npm](https://img.shields.io/npm/dm/hono)](https://www.npmjs.com/package/hono)
[![JSR](https://jsr.io/badges/@hono/hono)](https://jsr.io/@hono/hono)
[![Bundle Size](https://img.shields.io/bundlephobia/min/hono)](https://bundlephobia.com/result?p=hono)
[![Bundle Size](https://img.shields.io/bundlephobia/minzip/hono)](https://bundlephobia.com/result?p=hono)
[![GitHub commit activity](https://img.shields.io/github/commit-activity/m/honojs/hono)](https://github.com/honojs/hono/pulse)
[![GitHub last commit](https://img.shields.io/github/last-commit/honojs/hono)](https://github.com/honojs/hono/commits/main)
[![codecov](https://codecov.io/github/honojs/hono/graph/badge.svg)](https://codecov.io/github/honojs/hono)
[![Discord badge](https://img.shields.io/discord/1011308539819597844?label=Discord&logo=Discord)](https://discord.gg/KMh2eNSdxV)
2022-02-21 16:01:31 +01:00
2023-04-08 11:34:03 +02:00
Hono - _**\[炎\] means flame🔥 in Japanese**_ - is a small, simple, and ultrafast web framework for the Edges.
It works on any JavaScript runtime: Cloudflare Workers, Fastly Compute, Deno, Bun, Vercel, AWS Lambda, Lambda@Edge, and Node.js.
2023-05-14 01:33:34 +02:00
Fast, but not only fast.
2021-12-17 07:53:31 +01:00
2022-05-13 05:30:06 +02:00
```ts
import { Hono } from 'hono'
const app = new Hono()
2021-12-17 07:53:31 +01:00
app.get('/', (c) => c.text('Hono!'))
2021-12-17 07:53:31 +01:00
export default app
2021-12-17 07:53:31 +01:00
```
2023-02-22 21:47:56 +01:00
## Quick Start
```
npm create hono@latest
2023-02-22 21:47:56 +01:00
```
2022-01-08 01:48:22 +01:00
## Features
2021-12-17 07:53:31 +01:00
- **Ultrafast** 🚀 - The router `RegExpRouter` is really fast. Not using linear loops. Fast.
- **Lightweight** 🪶 - The `hono/tiny` preset is under 13kB. Hono has zero dependencies and uses only the Web Standard API.
- **Multi-runtime** 🌍 - Works on Cloudflare Workers, Fastly Compute, Deno, Bun, AWS Lambda, Lambda@Edge, or Node.js. The same code runs on all platforms.
- **Batteries Included** 🔋 - Hono has built-in middleware, custom middleware, and third-party middleware. Batteries included.
- **Delightful DX** 😃 - Super clean APIs. First-class TypeScript support. Now, we've got "Types".
2021-12-14 21:17:56 +01:00
## Documentation
2022-07-08 02:22:10 +02:00
The documentation is available on [hono.dev](https://hono.dev).
2021-12-14 21:31:37 +01:00
## Migration
The migration guide is available on [docs/MIGRATION.md](docs/MIGRATION.md).
2021-12-14 21:31:37 +01:00
## Communication
[Twitter](https://twitter.com/honojs) and [Discord channel](https://discord.gg/KMh2eNSdxV) are available.
## Contributing
2022-04-26 00:58:08 +02:00
Contributions Welcome! You can contribute in the following ways.
- Create an Issue - Propose a new feature. Report a bug.
- Pull Request - Fix a bug and typo. Refactor the code.
- Create third-party middleware - Instruct below.
- Share - Share your thoughts on the Blog, Twitter, and others.
- Make your application - Please try to use Hono.
For more details, see [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md).
2022-02-15 09:19:53 +01:00
## Contributors
2023-05-14 01:33:34 +02:00
Thanks to [all contributors](https://github.com/honojs/hono/graphs/contributors)!
2022-02-15 09:19:53 +01:00
2023-04-08 11:34:03 +02:00
## Authors
2021-12-14 20:26:22 +01:00
Yusuke Wada <https://github.com/yusukebe>
2023-05-14 01:33:34 +02:00
_RegExpRouter_, _SmartRouter_, _LinearRouter_, and _PatternRouter_ are created by Taku Amano <https://github.com/usualoma>
2021-12-14 20:26:22 +01:00
## License
2022-01-07 09:34:12 +01:00
Distributed under the MIT License. See [LICENSE](LICENSE) for more information.