ratzilla

Ratzilla

Build terminal-themed web applications with Rust and WebAssembly. Powered by Ratatui.

Quickstart

Templates

Install cargo-generate:

cargo install cargo-generate

Generate a new project:

cargo generate ratatui/ratzilla

And then serve the application on your browser ➡️

See templates for more information.

Manual Setup

Add Ratzilla as a dependency in your Cargo.toml:

cargo add ratzilla

Here is a minimal example:

…

Add your index.html. During build, trunk will automatically inject and initialize your Rust code (compiled to WebAssembly) as a JavaScript module.

…

And then serve the application on your browser ➡️

Serve

Install trunk to build and serve the web application.

cargo install --locked trunk

Add compilation target wasm32-unknown-unknown:

rustup target add wasm32-unknown-unknown

Then serve it on your browser:

trunk serve

Now go to http://localhost:8080 and enjoy TUIs in your browser!

Deploy

To build the WASM bundle, you can run the following command:

trunk build --release

Then you can serve the server from the dist directory.

#!/bin/bash
set -euo pipefail
export HOME=/root

# Install Rustup
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y -t wasm32-unknown-unknown --profile minimal
source "$HOME/.cargo/env"

# Install trunk using binstall
curl -L --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/cargo-bins/cargo-binstall/main/install-from-binstall-release.sh | bash
cargo binstall --targets x86_64-unknown-linux-musl -y trunk

# Build project with trunk
trunk build --release

Vercel

There is a Vercel deployment template available for Ratzilla here.

Documentation

• API Documentation
• Backends
• Widgets

Examples

• Minimal (Preview)
• Demo (Preview)
• Pong (Preview)
• Colors RGB (Preview)
• Animations (Preview)
• World Map (Preview)

Websites built with Ratzilla

• https://ratatui.github.io/ratzilla - The official website of Ratzilla
• https://terminalcollective.org - Terminal Collective community website
• https://www.function-type.com/tusistor - Resistor calculator
• http://timbeck.me - Personal website of Tim Beck
• https://map.apt-swarm.orca.toys - Map of apt-swarm p2p locations
• TachyonFX FTL - DSL editor and previewer for TachyonFX effects
• https://emrecansuster.com - Personal website of Emrecan Şuşter (source)
• https://junkdog.github.io/exabind - A tachyonfx tech demo: animated KDE keyboard shortcut viewer
• https://rbn.dev - Personal website of 0x01d (source)
• https://gluesql.org/glues - Glues, a Vim-inspired TUI note-taking app (source)
• https://alertangel.github.io/ - Website for AlertAngel: A device to make monitoring the Elderly a breeze. (source) (WIP)
• https://sdr-geo-db.vercel.app/ - SDR contact logging database (source)
• https://kana.rezoleo.fr - Learn Kana in a terminal fashion (source)
• https://shenoi.dev/twozero48 - A 2048 game (source)
• https://inowattio.github.io/MTUI/ - Modbus Client (source)

Acknowledgements

Thanks to Webatui projects for the inspiration.

Special thanks to:

• Martin Blasko for his huge help with the initial implementation.
• Adrian Papari for implementing WebGL2 backend.

Lastly, thanks to Ratatui for providing the core UI components.

Contributing

Pull requests are welcome!

Consider submitting your ideas via issues first and check out the existing issues.

License

Licensed under either of Apache License Version 2.0 or The MIT License at your option.

ノ( º _ º ノ) - respect crables!

Copyright

Copyright © 2025, Orhun Parmaksız