🍚 ricekit

A developer's TUI suite for Textual.

The themes, widgets, modals, icons, and design rules extracted from building ltui — and now powering its whole family (jtui, sctui, same repo) — everything a fast, clean, rice-friendly terminal app needs, minus the app.

what's in the box

see it

uv tool install git+https://github.com/Gheat1/ricekit
ricekit-gallery

The gallery demos the palette, icons, glyphs, widgets, and modals — cycle themes with t, live-preview every Textual theme with ctrl+p, drag the divider, press ?.

use it

uv add git+https://github.com/Gheat1/ricekit   # or pip install git+…

from textual.binding import Binding

from ricekit import KitApp, icons, palette
from ricekit.storage import AppDirs
from ricekit.widgets import KitFooter, NavList

DIRS = AppDirs("myapp")

class MyApp(KitApp):
    BINDINGS = [Binding("t", "cycle_kit_theme", "theme")]
    CSS = """
    NavList { border: round $kit-border; }
    NavList:focus { border: round $kit-border-focus; }
    """

    def compose(self):
        yield NavList(id="items")
        yield KitFooter()

    def on_mount(self):
        self.init_kit(theme=DIRS.load_state().get("theme"))

    def on_kit_theme_changed(self):
        if not self.kit_theme_previewing:
            DIRS.save_state({"theme": self.theme})

That's a themed, transparent-capable, live-previewing app in ~25 lines. Read DESIGN.md before building anything serious — especially the sharp-edges table.

the suite

• the tracker TUI suite — ltui (Linear), jtui (Jira), sctui (Shortcut); where all of this came from, now backed by Pantheon
• NaviTui — an animated terminal player for Navidrome, cover art and all
• yours next?

license

MIT — made by @Gheat1