fixing-gpuix-layout

Installation
SKILL.md

Fixing gpuix / GPUI layout

What draws what

Two renderers, and the fix lives in a different place depending on which one owns the pixels:

You see Owner Edit
Title bar, sidebar, tab rows, palette, banner, toasts React → @gpuix/react → GPUI packages/app/src/ui/**, packages/app/src/theme/tokens.ts
Terminal cells, cursor, selection, scrollbar native <terminal-grid> (Rust) crates/st-native/src/{geometry,paint,runs,props}.rs
Window frame, traffic lights, background GPUI window options packages/app/src/platform/window-options.ts

gpuix styles look like CSS but are a fixed allowlist mapped onto GPUI/taffy. Anything outside it is dropped without warning, which is why a plausible-looking style change can do nothing at all.

Check these first

Ordered by how often each one is the actual cause. Every entry here has bitten this codebase for real.

1. Missing display: 'flex' — flex props are inert without it

Installs
3
GitHub Stars
105
First Seen
Sep 6, 2026