Skip to content
HyperDesign System

Components

The 32 components in src/components/ui, grouped by what they do. Each card opens its page: every variant live, the props, and the code to copy. The previews are the real components.

Actions

Things you press: a command, or a state you switch on and off.

Form & input

Fields and controls that take a value, and the label that names them.

Overlays & menus

Surfaces that float over the page: menus, previews, panels and the modal. Drawn open here; open them for real on their pages.

Display & layout

Content, structure and status: the pieces that show things and hold them in place.

AvatarA person or agent at 24, 32 or 40px, image or initials, with a hairline rim.
BadgeThe 20px count, label and status pill in every variant.
Border beamA travelling light around the edge of one child, mono unless a surface earns colour.
CardThe rounded surface with header, title, description, content and footer slots.
CollapsibleAn unstyled disclosure: a trigger that shows and hides its content.
Icon tileA square, soft or round ground for an icon or a letter.
KbdA keycap for shortcuts, alone or grouped.
Nav itemA sidebar row: a pill that fills on hover and when active.
OverlineThe small caps heading over a group of items.
Scroll areaA scroll container with the house scrollbar thumb.
SeparatorA horizontal or vertical hairline between groups.
SkeletonA pulsing tint placeholder in the shape of content that is loading.
TabsSwitch between views with a pill track or an underline row.

Patterns

Composites in src/components/patterns. A shape earns a pattern only when two or more pages use it with the same intent.

PageHeading

patterns/page-heading.tsx

The h1, subtitle and actions row on every resource page.

SearchInput

patterns/search-input.tsx

The 36px pill search field every list page shares.

EmptyState

patterns/empty-state.tsx

Bubble or plain: an icon, a title, one line and an action.

ShowArchivedSwitch

patterns/show-archived-switch.tsx

The labelled switch beside list headers.