@wrkspace/shell
theme

Components

everything in @wrkspace/shell, live

the base surfaces and layout blocks

Frameview

bordered container. the base card everything else builds on.

a bordered frame
Panel

framed section with an optional header.

panel

panel body

Screen

full-bleed layout wrapper with brand, breadcrumbs, and actions.

screen content

Separator

labeled divider between sections.

beforeafter
Layout

flex and grid helpers: row, stack, grid, cell, spacer.

grid
grid
grid

inputs and the validation system

Inputview

single-line text input with a square border.

Textarea

multi-line text in a shell-code face.

Selectview

minimal dropdown picker, no chrome.

Checkboxview

a [x] marker instead of a tick box.

[]subscribe[x]checked
Radio

a (•) marker for exclusive choice.

()alpha()beta
Switch

a two-state toggle.

Sliderview

drag a thumb along a bordered track to pick a value.

40
NumberInputview

a numeric field with -/+ stepper buttons.

Comboboxview

type to filter a select.

TagsInputview

type to filter, pick multiple, remove with backspace.

Calendar

a month grid for picking a date, no library required.

august 2026
sumotuwethfrsa
DatePickerview

a calendar behind a popover trigger.

Formview

react-hook-form + zod validation with error messages.

FileUploadview

a dropzone to drag, drop or browse for files.

OtpInputview

one slot per digit, paste and autofill work out of the box.

PinInput

same field as OtpInput, entered characters masked.

buttons and the shortcuts behind them

Buttonview

five variants, mechanical press, dither loading.

Actionview

button with a keyboard shortcut binding.

Shortcut

keycap hint.

mod+k↑↓
Marker

the > selection cursor.

selected
Link

accent link, renders any element.

browse components
Toggleview

a two-state pressed/unpressed button.

ToggleGroupview

toggle buttons joined into one segmented control.

status dots, progress bars, loading placeholders

Status

a filled or hollow dot.

onoff
Progressview

dithered progress bar.

[]0%
Notice

inline banner with a tone.

!your quota is almost full
Alertview

bordered box with a title, description, and four tones.

Meter

labeled bar with a current value.

cpu
[]0%
Stat

label over a big number.

pastes12
tokens1
Toastview

transient notification, deduplicated.

Skeleton

dithered placeholder for loading regions.

Spinner

dithered inline loading indicator.

EmptyState

friendly nothing-here placeholder.

no pastes
create one to get started.
ErrorState

failure placeholder with a retry action.

failed to load
the server returned an error.

things that float above the page

Tooltipview

hover hint.

Dialogview

modal with backdrop, closes on esc.

Popover

non-modal floating panel.

DropdownMenuview

menu from a trigger, keyboard navigable.

ContextMenu

right-click menu.

right-click here
Confirmview

destructive confirmation dialog.

Sheet

side drawer, used for the mobile sidebar.

CommandPaletteview

type-to-filter command menu.

tabs, menus, breadcrumbs

Menu

static vertical menu.

Tabsview

segmented panel switcher.

12 pastes
Breadcrumb

path trail.

Pagination

page controls.

1 / 5
Stepsview

numbered progress through a multi-step flow.

  1. xdetails
  2. 2payment
  3. 3confirm
Accordion

expandable sections.

Collapsible

single show/hide region.

Tree

hierarchical list.

components
lib
package.json

tables, lists, code blocks

Tableview

grid table with zebra, hover, and row actions.

NAME
LANG
AGE
quiet-gecko
ts
2m
blue-pigeon
json
1h
happy-cat
text
1d
List

divided vertical list.

one
two
three
KeyValue

label / value pair.

namequiet-gecko
langtypescript
Code

inline code and code blocks.

inline code
const x = 1;
RichText

plain text with backtick spans rendered as code.

press mod+k to open the palette

Copyable

text with a copy button.

secret-token
Tag

small outlined label.

defaultaccentdanger
Path

renders a filesystem path.

~/projects/wrkspace
TerminalLine

a line of terminal output.

$ ls -la
AsciiDivider

a run of characters as a divider.

Prompt

an input that looks like a shell prompt.

>
HotkeyHint

keycap plus description.

mod+kpalette

the full application frame

AppShellview

the whole app frame: sidebar, topbar, main.

demo app
Sidebar

nav rail, collapses to a sheet on mobile.

Topbar

top strip with trigger and actions.

app / page
PageHeader

title, description, and actions for a page.

my pastes

12 pastes

UserMenu

avatar trigger with a dropdown.

the ordered dithering engine

DitherAvatarview

avatar derived from a name hash, dithered.

the wrksz logo as a dithered canvas.

DitherSurfaceview

a dithered background texture.