rendu

🏎️ JavaScript Hypertext Preprocessor.

Rendu is a lightweight toolkit for mixing HTML and JavaScript with a focus on simplicity, standards and progressive rendering.

> [!WARNING]
> This is an experimental PoC.

> [!NOTE]
> See playground (online playground) for demos and syntax section for usage.

CLI

Using the rendu CLI, you can start a local web server to serve static files and render .html files as templates (powered by srvx).

``sh
npx rendu
`

Programmatic API

$3

Compile a template string into a render function.

Example:

`ts
import { compileTemplate } from "rendu";

const template =

{{ title }}

• {{ item }}

- Type: array
- Default: ["htmlspecialchars","setCookie","redirect","$REQUEST","$METHOD","$URL","$HEADERS","$COOKIES","$RESPONSE"]

$3

Renders an HTML template to a Response object.

Example:

`ts
import { compileTemplate, renderToResponse } from "rendu";

const render = compileTemplate(template, { stream: true });

const response = await renderToResponse(render, { request });
`

Syntax

Rendu uses PHP-style tags to embed JavaScript within HTML templates:

$3

Use
`

$3

Use {{ expression }} for HTML-escaped output, or {{{ expression }}} or for unescaped (raw) output:

`html


Use for JavaScript control flow:

`html



No items found.

Use the echo() function for streaming content. Accepts: strings, functions, Promises, Response objects, or ReadableStreams:

Examples:

`html





`

$3

Access request context and global state:

- $REQUEST: The incoming Request object
- $METHOD: HTTP method (GET, POST, etc.)
- $URL: Request URL object
- $HEADERS: Request headers
- $RESPONSE: Response configuration object
- $COOKIES: Read-only object containing request cookies

$3

Use setCookie() function to set cookies in the response:

`html

`

Access cookies from the request using $COOKIES:

`html


Use redirect() function to redirect the user:

`html

`

$3

The htmlspecialchars() function is available for escaping HTML content:

> [!TIP]
> When using curly {{ }} syntax, htmlspecialchars will be automatically applied.

`html


Prior Art

- jaubourg/jhp
- atinux/pjs
- mde/ejs

License

Published under the MIT license.