Panel
PanelContent surface Give related content a place of its own. Semantic surfaces, layered treatments, and deliberate inner spacing.
Layout & contentPanel renders a section around a separate body container. Put spacing on the body when its children need breathing room.
In context
Design system
A shared foundation for your next interface.
Components
Themes
Tone, treatment, bodyClass, and the content slot work together in this summary.
<Panel tone="neutral" variant="surface" bodyClass="p-4">
<Flex align="center" justify="between" wrap="true">
<IconFrame name="lucide:layers" tone="feature" variant="surface"/>
<Badge tone="success">Ready</Badge>
</Flex>
<h3>Design system</h3>
<p>A shared foundation for your next interface.</p>
<Grid columns="2">
<div>
<strong>12</strong>
<p>Components</p>
</div>
<div>
<strong>2</strong>
<p>Themes</p>
</div>
</Grid>
<BtnLink href="/components/" tone="accent" variant="outline">Explore the system</BtnLink>
</Panel> A release summary
Combine a quiet surface with a clear heading, status and a real destination.
Release workspace
ReadyYour content, components and theme are ready for review.
Explore the library<Panel tone="neutral" variant="surface" bodyClass="p-4">
<Flex align="center" justify="between" wrap="true">
<h3 class="m-0">Release workspace</h3>
<Badge tone="success">Ready</Badge>
</Flex>
<p>Your content, components and theme are ready for review.</p>
<BtnLink href="/components/" tone="accent">Explore the library</BtnLink>
</Panel> Surface hierarchy
Use a stronger tone for important context and a quiet nested surface for supporting details.
Primary context
A surface connects related content.
Supporting context
An outline separates content without a second filled surface.
<Grid columns="1" columnsSm="2">
<Panel tone="accent" variant="surface" bodyClass="p-4">
<h3>Primary context</h3>
<p>A surface connects related content.</p>
<Panel tone="neutral" variant="outline" bodyClass="p-3">
Nested details stay readable.
</Panel>
</Panel>
<Panel tone="neutral" variant="outline" bodyClass="p-4">
<h3>Supporting context</h3>
<p>An outline separates content without a second filled surface.</p>
</Panel>
</Grid> A stateful link surface
The link provides navigation and keyboard semantics. The panel provides the visual response.
All semantic tones
All ten supported tones. A semantic palette communicates intent; visible labels keep the meaning explicit.
neutral Content with room to breathe.
accent Content with room to breathe.
feature Content with room to breathe.
secondary Content with room to breathe.
custom Content with room to breathe.
ghost Content with room to breathe.
info Content with room to breathe.
success Content with room to breathe.
warning Content with room to breathe.
danger Content with room to breathe.
Every value is visible. Compare treatments in the site’s light and dark themes.
All visual variants
All eighteen supported treatments, shown together.
solid surface Content with room to breathe.
surfaceAlt Content with room to breathe.
spotlight Content with room to breathe.
glass Content with room to breathe.
flat Content with room to breathe.
flatAlt Content with room to breathe.
flatSolid outlineFill outline Content with room to breathe.
subtle Content with room to breathe.
subtleBtn Content with room to breathe.
link Content with room to breathe.
sheen underline Content with room to breathe.
rail bracket Content with room to breathe.
none Content with room to breathe.
Every value is visible. Compare treatments in the site’s light and dark themes.
Variant modes
Stateless shows the base treatment. Stateful includes hover, focus, and active styling; it does not add an action handler.
stateless Content with room to breathe.
stateful Content with room to breathe.
Every value is visible. Compare treatments in the site’s light and dark themes.
Inner spacing and composition
bodyClass styles the inner body rather than the outer surface. variantMode can style a whole linked surface; a Panel itself is a section.
Compact Comfortable Room to read
A longer message fits comfortably.
Custom layout Every value is visible. Compare treatments in the site’s light and dark themes.
Behavior and accessibility
Panel does not add an action or an accessible label. Give content sections a heading; use a real link or button for interactions. Its default overflow is hidden: add the existing overflow-visible utility when a popup inside the panel needs to escape.
API reference
Panel contract
Props below are the public template API. RefOrValue accepts a literal or a reactive ref; bind refs with a colon-prefixed attribute. Native attributes and events can be passed through the component root.
tone
RefOrValue<SemanticTone> - Default
inherited
Semantic intent: neutral, accent, secondary, info, success, warning, danger, feature, custom or ghost. The active skin supplies the colors.
variant
RefOrValue<ComponentVariant> - Default
surface
Visual treatment. Accepts solid, surface, surfaceAlt, spotlight, glass, flat, flatAlt, flatSolid, outlineFill, outline, subtle, subtleBtn, link, sheen, underline, rail, bracket or none.
variantMode
RefOrValue<ComponentVariantMode> - Default
stateless
Use stateless for content surfaces; stateful enables the treatment’s hover, focus and active styles. It does not add interaction handlers.
bodyClass
RefOrValue<string> - Default
not set
Classes applied to the inner panel body. Use spacing utilities such as p-4 or layout utilities without changing the outer surface.
Composition
Default slot: arbitrary flow content inside the body. Register definePanelComponents; composed content registers its own component families.