Dicklesworthstone /frankentui
High-performance terminal UI kernel in Rust across 20 crates: diff-based rendering, inline mode, RAII cleanup, 70+ widgets, resizable pane workspaces, a Bayesian intelligence layer, and in-tree web/WASM backends (WebGPU with canvas2d fallback). 45 interactive demo screens run in the browser. WIP.
★ 299⑂ 29👁 1⑃ 71● 46▤ 10
+0
日增长
299
stars
29
forks
1
watchers
71
prs
46
issues
10
releases
README
FrankenTUI (ftui) ███████╗██████╗ █████╗ ███╗ ██╗██╗ ██╗███████╗███╗ ██╗████████╗██╗ ██╗██╗ ██╔════╝██╔══██╗██╔══██╗████╗ ██║██║ ██╔╝██╔════╝████╗ ██║╚══██╔══╝██║ ██║██║ █████╗ ██████╔╝███████║██╔██╗ ██║█████╔╝ █████╗ ██╔██╗ ██║ ██║ ██║ ██║██║ ██╔══╝ ██╔══██╗██╔══██║██║╚██╗██║██╔═██╗ ██╔══╝ ██║╚██╗██║ ██║ ██║ ██║██║ ██║ ██║ ██║██║ ██║██║ ╚████║██║ ██╗███████╗██║ ╚████║ ██║ ╚██████╔╝██║ ╚═╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═══╝╚═╝ ╚═╝╚══════╝╚═╝ ╚═══╝ ╚═╝ ╚═════╝ ╚═╝ High‑performance terminal UI kernel -- 1.1M+ lines of Rust across 20 crates, 70 widget/stateful-widget implementations across 55 widget types in ftui-widgets (93 across the workspace), 45 interactive demo screens, a Bayesian intelligence layer, resizable pane workspaces, and in-tree web/WASM backends -- focused on correctness, determinism, and clean architecture. !status !rust !license !crates !widgets !screens Try It in Your Browser All 45 screens run as WASM at frankentui.com/web — no install, no toolchain. It renders through WebGPU where that exists and falls back to canvas2d, so Chrome, Edge, Safari and Firefox all work. Phones too: swipe in from either edge to change screens, and the bar along the bottom carries a button for every key the current screen uses. Press and hold to drag; a divider drags straight away. Quick Run (from source) The primary way to see what the system can do is the demo showcase: cargo run -p ftui-demo-showcase (not the harness). bash Download source with curl (or grab prebuilt showcase binaries + SHA256SUMS from GitHub Releases) curl -fsSL https://codeload.github.com/Dicklesworthstone/frankentui/tar.gz/main | tar -xz cd frankentui-main Run the demo showcase (primary way to see what FrankenTUI can do) cargo run -p ftui-demo-showcase Or clone with git: bash git clone https://github.com/Dicklesworthstone/frankentui.git cd frankentui cargo run -p ftui-demo-showcase Toolchain. This checkout builds only with nightly Rust: rust-toolchain.toml pins a dated nightly, and .cargo/config.toml passes nightly-only -Z flags. You don't need to change your default toolchain. With rustup, every cargo command inside the checkout uses the pin even when your default is stable, and rustup installs it on first use. If automatic installs are off (RUSTUP_AUTO_INSTALL=0), run rustup toolchain install in the checkout first. Two settings outrank the pin: a RUSTUP_TOOLCHAIN environment variable and a rustup override for the directory. Run rustup show active-toolchain in the checkout to see which toolchain is in effect and why. If it names stable, unset whichever setting it reports, or name the pinned nightly explicitly. The date is the channel value in rust-toolchain.toml: bash cargo +nightly-YYYY-MM-DD run -p ftui-demo-showcase --- TL;DR The Problem: Most TUI stacks make it easy to draw widgets, but hard to build correct, flicker‑free, inline UIs with strict terminal cleanup and deterministic rendering. The Sol
Top issues
#102v0.9.0 release hold: bidi editor mixes grapheme/scalar maps and logical rendering1 comments · 2026-10-02#115layout_lab parity test fails nondeterministically when the full showcase suite runs on a high-core machine0 comments · 2026-11-07#104RenderBudget does not present a frame that ran over budget; with steadily slow frames the UI never updates again0 comments · 2026-10-13#103ftui-runtime: locale::tests::set_direction_override_wins_and_bumps_version fails when run alongside the other locale tests0 comments · 2026-10-03#96Workspace test gate: 9 failures, 3 binaries — Arabic locale label renders in reversed visual order0 comments · 2026-09-19
Latest release
FrankenTUI v0.10.0 v0.10.0 2026-11-03FrankenTUI 0.10.0 keeps slow views live and gets inline logs into scrollback. A frame that runs past its budget is now presented instead of dropped, so an application with a steadily slow view() no longer looks frozen (104), and inline-mode log lines now reach the terminal's history under tmux, GNU screen and zellij, and survive resizes. All 17 library crates go from 0.9.0 to 0.10.0 on crates.io. This release has breaking API changes, listed under Changed in the CHANGELOG; read them before upgrading. Highlights: - A late frame is presented, not dropped (104). The frame budget skips a frame b