{"full_name":"ratatui/ratatui","owner":"ratatui","name":"ratatui","shard":"1","url":"https://github.com/ratatui/ratatui","description":"A Rust crate for cooking up terminal user interfaces (TUIs) 👨‍🍳🐀 https://ratatui.rs","homepage":"https://ratatui.rs","topics":["rust","terminal","tui","cli","widgets","ratatui","terminal-user-interface"],"tag_pages":["cli","rust","terminal","tui","widgets"],"language":"Rust","license":"MIT","avatar":"https://avatars.githubusercontent.com/u/125200832?v=4","created_at":"2023-02-12T21:56:20Z","pushed_at":"2026-11-12T17:50:08Z","metrics":{"stars":23322,"forks":826,"watchers":60,"issues":569,"prs":2144,"releases":138,"issues_open":141,"issues_closed":428,"prs_open":57,"prs_closed":321,"prs_merged":1766,"discussions":164},"growth":{},"history":{"dates":["2026-11-16"],"stars":[23322],"forks":[826],"watchers":[60],"issues_open":[141],"prs_open":[57]},"boards":{},"same_owner":[],"issues":[{"number":996,"title":"Rename `render_ref` for `StatefulWidgetRef` to `render_stateful_ref`","comments":27,"created_at":"2024-03-24T23:20:20Z"},{"number":1271,"title":"Fix unicode text width calculation","comments":24,"created_at":"2024-08-03T04:18:23Z"},{"number":1468,"title":"Connecting blocks","comments":19,"created_at":"2024-11-04T07:27:24Z"},{"number":779,"title":"Example code compatibility with Ratatui versions","comments":19,"created_at":"2024-01-10T07:42:45Z"},{"number":2397,"title":"are the mice cheese-starved? memory usage on embedded.","comments":18,"created_at":"2026-02-14T22:16:08Z"},{"number":1028,"title":"Support styling as a hyperlink","comments":18,"created_at":"2024-04-12T13:34:29Z"},{"number":2269,"title":"Notifications feature crate for Ratatui","comments":16,"created_at":"2025-12-15T02:20:32Z"},{"number":1855,"title":"Ratatui hangs / high cpu: Resolving Layout constraints might loop indefinitely.","comments":16,"created_at":"2025-05-14T14:42:59Z"}],"discussions":[{"number":2916,"title":"Show and Tell: r/RatatuiRust - a community for Ratatui developers","comments":0,"category":"Discussion","created_at":"2026-11-15T15:23:49Z"},{"number":2806,"title":"WebAssembly plugin widgets for Ratatui","comments":1,"category":"Ideas","created_at":"2026-10-03T12:23:25Z"},{"number":2729,"title":"New release discussion","comments":1,"category":"Discussion","created_at":"2026-08-23T19:05:44Z"},{"number":2690,"title":"Ratlings: small exercises to learn Ratatui","comments":5,"category":"Ideas","created_at":"2026-08-04T23:04:54Z"},{"number":2689,"title":"Exporting a rendered Buffer to a static image (SVG), for documentation","comments":1,"category":"Ideas","created_at":"2026-08-04T20:26:56Z"},{"number":2682,"title":"Why not use char instead of CompactString for Cell symbol?","comments":1,"category":"Discussion","created_at":"2026-07-30T10:21:40Z"},{"number":2650,"title":"Why does the combination of Inline Viewport and warp's Paragraph cause continuous printing of new lines?","comments":1,"category":"Q&A","created_at":"2026-07-16T09:13:03Z"},{"number":2888,"title":"a11y support","comments":22,"category":"Ideas","created_at":"2026-06-19T14:22:19Z"}],"latest_release":{"name":"ratatui-v0.30.2","tag":"ratatui-v0.30.2","published_at":"2026-06-19T08:56:52Z","body":"![a gift](https://github.com/ratatui/ratatui-website/raw/refs/heads/main/src/assets/a-gift.png)\n\nWe are excited to announce the new version of `ratatui` - a Rust library that's all about cooking up TUIs 👨‍🍳🐀\n\n✨ **Release highlights**: <https://ratatui.rs/highlights/v0302/>\n\n⚠️ List of breaking changes can be found [here](https://github.com/ratatui/ratatui/blob/main/BREAKING-CHANGES.md).\n\n### Features\n\n- [90639c1](https://github.com/ratatui/ratatui/commit/90639c179ddcbe483ea05f21b1ce3fa09767441a) *(uncategorized)* Add Termina backend by `@joshka` in [#2561](https://github.com/ratatui/ratatui/pull/2561)\n\n  > ## Summary\n  >\n  > - add the `ratatui-termina` backend crate using the published `termina`\n  > crate\n  > - expose the backend through the `termina` feature and Ratatui\n  > prelude/backend re-exports\n  > - add a small Termina event-loop example and wire the backend into CI,\n  > xtask, README generation, and docs\n  >\n  > Refs #1784\n  >\n  > ## Validation\n  >\n  > - `cargo +nightly fmt`\n  > - `cargo check -p ratatui-termina --all-features --all-targets`\n  > - `cargo check -p ratatui --no-default-features --features termina`\n  > - `cargo check -p xtask`\n  > - `cargo check -p release-header`\n  > - `cargo xtask check-backend termina`\n  > - `cargo xtask test-backend termina`\n  > - `cargo xtask rdme --check`\n  > - `markdownlint-cli2 ARCHITECTURE.md ratatui-termina/README.md\n  > .github/ISSUE_TEMPLATE/bug_report.md`\n  >\n  > ---------\n\n### Bug Fixes\n\n- [fce3c80](https://github.com/ratatui/ratatui/commit/fce3c80d53d5cf367e62cadf1d5c819947d23e4c) *(widgets)* Require thread-safe shadow effects by `@joshka` in [#2584](https://github.com/ratatui/ratatui/pull/2584)\n\n  > ## Summary\n  >\n  > - require custom shadow effects to preserve the auto traits expected by\n  > Block-backed widgets\n  > - document the CellEffect auto-trait contract\n  > - add a public widget regression test for the affected ratatui::widgets\n  > re-exports\n  >\n  > Fixes #2583\n  >\n  > ---------\n\n- [e306ce6](https://github.com/ratatui/ratatui/commit/e306ce69df3113d41c00c483e36ba3ecc88f3c79) *(buffer)* Create updates for \"uncovered\" cells by `@benjajaja` in [#2587](https://github.com/ratatui/ratatui/pull/2587)\n\n  > When a wide cell from the previous buffer is replaced by a short/normal\n  > cell, the trailing cell does not get an update if its content does not\n  > change. But if the wide cell has a background (or other) style, the\n  > terminal *did* render the trailing cell with that style.\n  >\n  > Force trailing cells to update if background, underline, or modifiers\n  > are different than the wide cell. We can ignore foreground.\n  >\n  > Fixes #2585 (see that for the detailed visual reports)\n\n- [81e667f](https://github.com/ratatui/ratatui/commit/81e667f354489a809e0db1f95e378efe859dd409) *(scrollbar)* Keep a large thumb within the track at the end by `@satyakwok` in [#2594](https://github.com/ratatui/ratatui/pull/2594)\n  >\n  > Closes #2582.\n  >\n  > ## Problem\n  >\n  > When the content is shorter than the viewport, the thumb is large\n  > relative to the track. With the position at the end, `part_lengths`\n  > clamped `thumb_start` to `track_length - 1` while `thumb_length` was\n  > clamped independently to `[1, track_length]`, so `thumb_start +\n  > thumb_length` could exceed `track_length`.\n  >\n  > `bar_symbols` lays out `begin + track_start + thumb + track_end + end`\n  > and zips it against the cells of the area. When the thumb overruns the\n  > track, `track_end` saturates to `0` but the thumb still emits more cells\n  > than the track can hold, so the trailing `end` symbol is pushed past the\n  > end of the area. The last visible cell ends up being a thumb (`█`) where\n  > the end arrow (`▼`) should be.\n  >\n  > Concretely, for the issue's repro (`VerticalRight`, `content_length =\n  > 9`, `position = 8`, height `24`): track is `22`, `thumb_length = 17`,\n  > `thumb_start = 6`, and `6 + 17 = 23 > 22`.\n  >\n  > This is a regression from v0.30.0, where `thumb_length` was derived as\n  > `thumb","is_prerelease":false},"readme":true,"readme_zh":false,"news":[],"stale":false,"snapshot_at":"2026-11-16T09:23:14Z","history_start":"2026-09-06"}