# tui-realm-stdlib
<p align="center">
<img src="docs/images/tui-realm.svg" width="256" alt="logo" height="256" />
</p>
<p align="center">~ A tui-rs framework inspired by Elm and React ~</p>
<p align="center">
<a href="https://docs.rs/tui-realm-stdlib" target="_blank">Documentation</a>
</p>
<p align="center">Developed by <a href="https://veeso.me/" target="_blank">@veeso</a></p>
<p align="center">Current version: 4.0.0 (2026-04-18)</p>
<p align="center">
<a href="https://opensource.org/licenses/MIT"
><img
src="https://img.shields.io/badge/License-MIT-teal.svg"
alt="License-MIT"
/></a>
<a href="https://crates.io/crates/tui-realm-stdlib"
><img
src="https://img.shields.io/crates/d/tui-realm-stdlib.svg"
alt="Downloads counter"
/></a>
<a href="https://crates.io/crates/tui-realm-stdlib"
><img
src="https://img.shields.io/crates/v/tui-realm-stdlib.svg"
alt="Latest version"
/></a>
<a href="https://ko-fi.com/veeso">
<img
src="https://img.shields.io/badge/donate-ko--fi-red"
alt="Ko-fi"
/></a>
</p>
---
- [tui-realm-stdlib](#tui-realm-stdlib)
- [About tui-realm-stdlib 👑](#about-tui-realm-stdlib-)
- [Get started 🏁](#get-started-)
- [Add tui-realm to your Cargo.toml 🦀](#add-tui-realm-to-your-cargotoml-)
- [Support the developer ☕](#support-the-developer-)
- [Components 🎨](#components-)
- [Utilities](#utilities)
- [Documentation 📚](#documentation-)
- [Contributing and issues 🤝🏻](#contributing-and-issues-)
- [Changelog ⏳](#changelog-)
- [License 📃](#license-)
---
## About tui-realm-stdlib 👑
tui-realm-stdlib is the standard component library for [tui-realm](https://github.com/veeso/tui-realm).
It provides several **Components** for your tui-realm applications. Probably all the components you need are here 😉
---
## Get started 🏁
### Add tui-realm to your Cargo.toml 🦀
```toml
tui-realm = "4"
tui-realm-stdlib = "4"
```
or if you're not using the default **crossterm backend**, specify another backend in the cargo entry:
```toml
tui-realm = { version = "4", default-features = false, features = [ "termion" ] }
```
---
## Support the developer ☕
If you like tui-realm and you're grateful for the work I've done, please consider a little donation 🥳
You can make a donation with one of these platforms:
[](https://ko-fi.com/veeso)
[](https://www.paypal.me/chrisintin)
---
## Components 🎨
All the components implemented in the standard library can be viewed in the [components wiki](docs/components.md).
---
### Utilities
The standard components library also exports the `utils` module, which provides these very handy functions:
- **wrap_spans**: Creates span lines from text spans, in order to wrap lines
- **use_or_default_styles**: use colors and modifiers of the text spans if not `Color::Reset` or `Modifiers::empty()`, otherwise use the properties defined the `Props`.
- **get_block**: creates the block for the widget. If focus is true, the colors are applied, otherwise `Color::Reset`.
---
## Documentation 📚
The developer documentation can be found on Rust Docs at <https://docs.rs/tui-realm-stdlib>
---
## Contributing and issues 🤝🏻
Contributions, bug reports, new features and questions are welcome! 😉
If you have any question or concern, or you want to suggest a new feature, or you want just want to improve tui-realm-stdlib, feel free to open an issue or a PR.
Please follow [our contributing guidelines](CONTRIBUTING.md)
---
## Changelog ⏳
View tui-realm's [Changelog](../../CHANGELOG.md).
---
## License 📃
tui-realm-stdlib is licensed under the MIT license.
You can read the entire [License](LICENSE).