Workspace
Status bar
The bottom strip of the application chrome — left, centre and right groups, tones, hairline separators, truncation and a mono type scale
mainLn 12, Col 4packages/shell/src/toolbar/toolbar.tsxUTF-83 errors
Usage
import { StatusBar } from "@gpuixui/shell";
<StatusBar
label="Editor status"
left={[
{ id: "branch", label: "main" },
{ id: "position", label: "Ln 12, Col 4" },
]}
center={[{ id: "file", label: "packages/shell/src/status-bar/status-bar.tsx" }]}
right={[
{ id: "encoding", label: "UTF-8" },
{ id: "errors", label: "3 errors", tone: "destructive" },
]}
/>;Anatomy
gpui-kit's bar has three regions and the centre follows the pinned ends:
leftpins to the leading edge andrightto the trailing edge.centeris centred when both pinned groups have items, end-aligned when onlyleftdoes, and start-aligned otherwise. The rule iscenterAlignmentand it treats an empty group as absent.- A hairline
1pxseparator sits between the items of one group, never around the group. - Every label truncates (
overflow: hidden,textOverflow: ellipsis,nowrap) and shrinks before the group would overflow. - Labels are
text-xsin the theme's mono scale — a status readout is scanned, not read as prose. tonepaints a status role's readable foreground;defaultkeeps the bar's own foreground.
API
| Part | Renders | Props |
|---|---|---|
StatusBar | div with role="status" | label?, left?, center?, right?, className? |
StatusBarItem | one <text> in a group | id, label, tone? |
Edit this page on GitHubpackages/shell/docs/status-bar.mdx