2024-11-17 23:03:44 +00:00
|
|
|
# Ratatui Core
|
2024-11-06 06:10:49 +00:00
|
|
|
|
|
|
|
[![Crates.io](https://img.shields.io/crates/v/ratatui-core)](https://crates.io/crates/ratatui-core)
|
|
|
|
[![Documentation](https://docs.rs/ratatui-core/badge.svg)](https://docs.rs/ratatui-core)
|
|
|
|
[![License](https://img.shields.io/crates/l/ratatui-core)](../LICENSE)
|
|
|
|
|
2024-11-17 23:03:44 +00:00
|
|
|
<!-- ⚠️ DO NOT EDIT THIS FILE DIRECTLY, EDIT lib.rs AND THEN RUN `cargo rdme` to update this file. -->
|
|
|
|
<!-- cargo-rdme start -->
|
2024-11-06 06:10:49 +00:00
|
|
|
|
2024-11-17 23:03:44 +00:00
|
|
|
**ratatui-core** is the core library of the [ratatui] project,
|
2024-11-06 06:10:49 +00:00
|
|
|
providing the essential building blocks for creating rich terminal user interfaces in Rust.
|
|
|
|
|
2024-11-17 23:03:44 +00:00
|
|
|
[ratatui]: https://github.com/ratatui/ratatui
|
|
|
|
|
|
|
|
### Why `ratatui-core`?
|
2024-11-06 06:10:49 +00:00
|
|
|
|
|
|
|
The `ratatui-core` crate is split from the main [`ratatui`](https://crates.io/crates/ratatui) crate
|
2024-11-17 23:03:44 +00:00
|
|
|
to offer better stability for widget library authors. Widget libraries should generally depend
|
|
|
|
on `ratatui-core`, benefiting from a stable API and reducing the need for frequent updates.
|
|
|
|
|
|
|
|
Applications, on the other hand, should depend on the main `ratatui` crate, which includes
|
|
|
|
built-in widgets and additional features.
|
2024-11-06 06:10:49 +00:00
|
|
|
|
|
|
|
## Installation
|
|
|
|
|
|
|
|
Add `ratatui-core` to your `Cargo.toml`:
|
|
|
|
|
|
|
|
```shell
|
|
|
|
cargo add ratatui-core
|
|
|
|
```
|
|
|
|
|
|
|
|
## Contributing
|
|
|
|
|
2024-11-17 23:03:44 +00:00
|
|
|
We welcome contributions from the community! Please see our [CONTRIBUTING](../CONTRIBUTING.md)
|
|
|
|
guide for more details on how to get involved.
|
2024-11-06 06:10:49 +00:00
|
|
|
|
2024-11-17 23:03:44 +00:00
|
|
|
### License
|
2024-11-06 06:10:49 +00:00
|
|
|
|
|
|
|
This project is licensed under the MIT License. See the [LICENSE](../LICENSE) file for details.
|
2024-11-17 23:03:44 +00:00
|
|
|
|
|
|
|
<!-- cargo-rdme end -->
|