ratatui/ratatui-termwiz
Josh McKinney 2d713d723d
feat(crossterm): allow multiple crossterm versions (#1841)
This commit introduces feature flags to make it possible for widget
library authors to depend on a specific version of crossterm without
causing version conflicts. This should make it easier for libraries and 
apps to update crossterm versions more easily.

The available feature flags are `crossterm_0_28` and `crossterm_0_29`.
By default, the latest version is enabled. If a multiple features are
enabled we choose the latest version. We will in general support at
least the last two major (0.x) versions of crossterm, and will only
remove versions in a major version bump.
2025-08-17 12:43:18 -07:00
..

Ratatui-termwiz

This module provides the [TermwizBackend] implementation for the Backend trait. It uses the Termwiz crate to interact with the terminal.

Crate Organization

ratatui-termwiz is part of the Ratatui workspace that was modularized in version 0.30.0. This crate provides the Termwiz backend implementation for Ratatui.

When to use ratatui-termwiz:

  • You need fine-grained control over dependencies
  • Building a widget library that needs backend functionality
  • You want to use only the Termwiz backend without other backends
  • You need Termwiz's advanced terminal capabilities

When to use the main ratatui crate:

  • Building applications (recommended - includes termwiz backend when enabled)
  • You want the convenience of having everything available

For detailed information about the workspace organization, see ARCHITECTURE.md.