Home

Home

Yororen UI is a UI component library for GPUI (via the gpui-ce crate).

A button is not a visual — it is a focusable, clickable thing with a label and an optional icon. The visual is a plug-in.

theme JSON  ─▶  renderer (XxxRenderer)  ─▶  headless (XxxProps)  ─▶  gpui-ce

• Headless (yororen-ui-core) — data, state, a11y. No visual decisions.
• Renderer (yororen-ui-default-renderer or yororen-ui-brutalism-renderer) — turns props into a styled div. Swap the renderer, change the entire look.
• Theme — a JSON file. The renderer reads paths like action.primary.bg; missing paths fall back to renderer defaults.

Get started

• Quick start — bootstrap a GPUI app and render your first component.
• Recommended practices — the rules every app converges on.
• Composing UI — list rows, toolbar + content, modal forms.
• Theming — read tokens, write a JSON theme, swap at runtime.

Architecture

• 3-layer architecture — the mental model.
• Keyed state — why .id(...) survives re-renders.
• Layout rules — what headless factories don't decide.
• Virtualization — VirtualList and VirtualRow.
• Accessibility — a11y/* primitives.
• Internationalization — cx.t(...), RTL, locales.

Recipes

• Settings form — Form + inputs + validation.
• Search + results — SearchInput + VirtualList.
• Context menu — Popover + right-click.
• List / tree row — VirtualRow + ListItem.
• Empty state — EmptyState.

Demos

• Demos — 7 runnable apps under crates/yororen-ui-demos/.

Reference

• Components — every headless factory, one entry each.
• Widgets — composed multi-component patterns.
• Changelog.

Project

• About — what Yororen UI is and is not.
• Repository: https://github.com/MeowLynxSea/yororen-ui
• License: Apache-2.0