NHttp
An Simple web-framework for Deno and Friends.
## Features
- Focus on simple and easy to use.
- Fast Performance.
[One of the fastest Frameworks](https://github.com/denosaurs/bench#hello-bench).
- Cross runtime support (Deno, Node, Bun, etc).
- Low overhead & True handlers (no caching anything).
- Built-in Middleware.
- Sub router support.
- Template engine support (jsx, ejs, nunjucks, eta, pug, ..etc).
- Return directly on handlers.
- Auto parses the body (`json / urlencoded / multipart / raw`).
[See Examples](https://github.com/nhttp/nhttp/tree/master/examples)
> v1.3.0 requires Deno 1.35 or higher.
## CLI
### Deno
```bash
deno run -Ar npm:create-nhttp
```
### Npm
```bash
npm create nhttp@latest
```
## Manual Installation
### deno.land
```ts
import nhttp from "https://deno.land/x/nhttp/mod.ts";
```
### deno-npm
```ts
import nhttp from "npm:nhttp-land";
```
### npm/yarn
```bash
npm i nhttp-land
// or
yarn add nhttp-land
```
```ts
// module
import nhttp from "nhttp-land";
// commonjs
const nhttp = require("nhttp-land").default;
```
## Simple Usage
Create file `app.ts` and copy-paste this code.
```ts
import nhttp from "https://deno.land/x/nhttp/mod.ts";
const app = nhttp();
app.get("/", () => {
return "Hello, World";
});
app.get("/cat", () => {
return { name: "cat" };
});
app.listen(8000);
```
### Run
```bash
deno run -A app.ts
```
## Using JSX + Htmx
Create file `app.tsx` and copy-paste this code.
```jsx
/** @jsx n */
/** @jsxFrag n.Fragment */
import nhttp from "https://deno.land/x/nhttp/mod.ts";
import { htmx, n, renderToHtml } from "https://deno.land/x/nhttp/lib/jsx.ts";
const app = nhttp();
app.engine(renderToHtml);
app.use(htmx());
app.get("/", () => {
return (
);
});
app.post("/clicked", () => {
return It's Me;
});
app.listen(8000);
```
### Run
```bash
deno run -A app.tsx
```
more docs => https://nhttp.deno.dev
## 3rd-party libs
Like `std-libs` for NHttp.
### Usage
```ts
// Deno
import {...} from "https://deno.land/x/nhttp/lib/my-libs.ts";
// Deno NPM
import {...} from "npm:nhttp-land/my-libs";
// Node or Bun
import {...} from "nhttp-land/my-libs";
```
### ServeStatic
```ts
import nhttp from "https://deno.land/x/nhttp/mod.ts";
import serveStatic from "https://deno.land/x/nhttp/lib/serve-static.ts";
const app = nhttp();
app.use(serveStatic("./my_folder"));
// with prefix
app.use(serveStatic("./my_folder", { prefix: "/assets" }));
// or
// app.use("/assets", serveStatic("./my_folder"));
// with URL
app.use(serveStatic(new URL("./my_folder", import.meta.url)));
```
more libs => https://nhttp.deno.dev/docs/3rd-party-lib
## License
[MIT](LICENSE)