Packages

Rezi is organized as a monorepo with focused packages and clear runtime boundaries.

Installation

Most applications need only two packages:

npm install @rezi-ui/core @rezi-ui/node
# or
bun add @rezi-ui/core @rezi-ui/node

Package Overview

@rezi-ui/core

Runtime-agnostic TypeScript core

The core package defines Rezi's runtime-agnostic API and contains:

• All widget constructors (ui.text, ui.button, ui.table, etc.)
• Layout engine with flexbox-like semantics
• Theme system with six built-in presets
• Form management and validation
• Keybinding parser with chord support
• Focus management utilities
• Binary protocol builders and parsers

This package has no Node.js-specific dependencies. Runtime adapters can reuse it by implementing the backend contract.

import { ui, rgb, darkTheme } from "@rezi-ui/core";

Full documentation →

@rezi-ui/node

Node.js/Bun runtime backend

The @rezi-ui/node backend provides runtime integration:

• Execution modes: worker, inline, and auto
• Worker-mode transport and scheduling
• Event loop integration
• Terminal capability detection
• Debug tracing and performance instrumentation

import { createNodeApp } from "@rezi-ui/node";

const app = createNodeApp({
    initialState: {},
});

Full documentation →

@rezi-ui/native

Native addon (N-API + Zireael)

The native package contains the napi-rs binding to the Zireael C rendering engine:

• Terminal I/O with platform-specific optimizations
• Binary protocol handling
• Prebuilt binaries for Linux, macOS, and Windows

This package is automatically installed as a dependency of @rezi-ui/node.

Full documentation →

@rezi-ui/testkit

Testing utilities

Helper package for testing Rezi applications:

• Mock backends for unit testing
• Test fixtures for protocol testing
• Golden file comparison utilities
• Text snapshot assertions for rendered frames

npm install --save-dev @rezi-ui/testkit
# or
bun add -d @rezi-ui/testkit

Full documentation →

create-rezi

Project scaffolding CLI

Generate a ready-to-run Rezi app with TypeScript configured and polished starter templates (dashboard, stress-test, cli-tool, minimal):

npm create rezi my-app
# or
bun create rezi my-app

Full documentation →

@rezi-ui/jsx

JSX runtime

Native JSX runtime that maps JSX elements directly to Rezi VNodes (no React required):

npm install @rezi-ui/jsx
# or
bun add @rezi-ui/jsx

Full documentation → | Getting started →

Dependency Flow

The package dependency structure enforces a clean separation of concerns:

Application Code (ui.* API or JSX)
       │
       ├─── @rezi-ui/jsx (optional JSX runtime)
       │
       ▼
@rezi-ui/core (No Node APIs)
       │
       │ used by
       ▼
@rezi-ui/node (worker/inline execution, event loop)
       │
       │ binds to
       ▼
@rezi-ui/native (C engine via N-API)
       │
       ▼
Zireael C Engine (Terminal rendering)

Versioning

All publishable packages share a single version number. This simplifies dependency management and ensures compatibility between packages.

Current versions can be checked in each package's package.json or via npm:

npm info @rezi-ui/core version
npm info @rezi-ui/node version

Development Packages

The following packages are used for development only and are not published: