# tui-term
[](https://crates.io/crates/tui-term)
[](https://docs.rs/tui-term)
[](https://matrix.to/#/#tui-term-main:matrix.org)
A pseudoterminal widget for the [ratatui](https://github.com/tui-rs-revival/ratatui) crate.

## Status
NOTE: This project is currently in active development and should be considered as work in progress.
It can not be considered stable yet.
The goal of tui-term is to provide a robust and well-tested pseudoterminal widget for users of the ratatui crate.
## Installation
To use `tui-term`, simply add it as a dependency in your Cargo.toml file:
```
[dependencies]
tui-term = "0.1.0"
```
or use `cargo add`:
```
cargo add tui-term
```
## Examples
Check out the examples directory, for more information, or run an example:
```
cargo run --example simple_ls
```
## Chat Room
Join our matrix chat room, for possibly synchronous communication.
## Architecture
For a top-level understanding of the architecture of `tui-term` and the design choices made, please refer to the [Architecture](docs/ARCHITECTURE.md) document.
## Contributing
We welcome contributions from the community! If you're interested in contributing to tui-term, please refer to the contribution guidelines for instructions on how to get started.
[How to contribute.](./docs/CONTRIBUTING.md)
## Changes
[Changelog](./CHANGELOG.md)
## License
MIT