Skip to content

Latest commit

 

History

History

README.md

iocraft-builder

Native Node.js bindings for the iocraft TUI library via napi-rs.

Overview

This package builds iocraft (a React-like declarative TUI framework for Rust) as a native Node.js addon, enabling polished terminal user interfaces in Node.js applications with:

  • Flexbox layouts (via taffy)
  • Mouse support
  • Keyboard input handling
  • Rich text styling and colors
  • Component-based architecture

Build

pnpm --filter iocraft-builder run build        # dev build, incremental via checkpoints
pnpm --filter iocraft-builder run build:force  # force rebuild from scratch

First time only: install the Rust toolchain (cargo + rustup) — the postinstall probes for it and will fail early if missing.

Output: build/<mode>/<platform-arch>/out/<platform-arch>/iocraft.node (native Node-API addon, consumed by socket-cli). CI builds also place a copy at build/<mode>/<platform-arch>/out/Final/iocraft.node for artifact upload.