A raised surface for one task in the stand-alone apps: a question, a result, a form.

Organism · stable · v1.0.0 · owner: Site system lead · contract 19 of 20 points (open: figma)

Do and don't

Do: Question

Rendered by panel.ts

Open example: Panel · Do: Question Use the full-page example to follow page links.

One task.

Do: Form

Rendered by panel.ts

Open example: Panel · Do: Form Use the full-page example to follow page links.

A form panel.

Don't: Two tasks

Rendered by panel.ts

Open example: Panel · Don't: Two tasks Use the full-page example to follow page links.

One task per panel.

Don't: With a shadow

Rendered by panel.ts

Open example: Panel · Don't: With a shadow Use the full-page example to follow page links.

Tone raises a panel, not shadow.

Rules

RuleWhyCheck
One task per panel.Calm, focused apps.Review: Owner

API

PropTypeRequiredDefaultWhat it does
titlestringNoThe panel's heading.
htmlhtmlYesThe content.
formbooleanNofalseA form panel.

Contract details

The full contract: identity, anatomy, variants, states, tokens, layout, motion, accessibility, content, tests

Identity

AspectValue
Idpanel
LayerOrganisms
Categorycontainer
OwnerSite system lead
Statusstable
Version1.0.0
Sourceapps/showcase/site/system/organisms/panel.ts (private repository; the contract and the render function are this one module)
VersionDateChange
1.0.02026-10-26Panel as one module: its markup moved out of the page builder (scripts/site) into the system.

Use when

  • The health check, survey and contact apps. Why: One task per panel keeps the app calm.

Do not use when

  • On marketing pages. Why: Marketing pages use templates and fields.

Anatomy

PartWhat it is
rootdiv.panel (+ panel-form)
titleh2.card-title
bodyThe task

Made of: heading, text.

Used in: contact-form, health-check, survey.

Variants

VariantWhenWhy
defaultWherever the page declaration places it.One shape per job keeps pages predictable.

States

StateRendered or not applicable
defaultdefault
hoverNot applicable: The panel is not interactive, so it has no hover state.
focus-visibleNot applicable: The panel does not take focus; links and buttons inside it carry their own focus ring.
activeNot applicable: The panel cannot be pressed.
disabledNot applicable: The panel has nothing to disable.
loadingNot applicable: The panel is rendered at build time and is complete when the page loads.
emptyNot applicable: The panel is not rendered without content; the builder skips it.
errorNot applicable: The panel shows no data that can fail.
currentNot applicable: The panel has no current item.
visitedNot applicable: The panel is not a link.
expandedNot applicable: The panel does not open or close.

Tokens

PartToken
panel.background--surface
panel.border--rule-hair --line
--panel-gap-space-5var(--space-5)
--panel-padding-space-8var(--space-8)
--panel-background-surfacevar(--surface)
--panel-border-top-rule-framevar(--rule-frame)
--panel-border-top-inkvar(--ink)
--panel-border-radius-radiusvar(--radius)
--panel-card-rule-band-wovenvar(--band-woven)
--panel-card-rule-band-holdingvar(--band-holding)
--panel-card-rule-saffronvar(--saffron)
--panel-card-rule-band-loosevar(--band-loose)
--panel-font-type-h3var(--type-h3)
--panel-letter-spacing-ls-h3var(--ls-h3)
--panel-background-field-inkvar(--field-ink)
--panel-color-on-dyevar(--on-dye)
--panel-border-top-color-saffronvar(--saffron)
--panel-color-on-dye-2var(--on-dye-2)
--panel-padding-space-7var(--space-7)
--panel-padding-space-6var(--space-6)

Layout

AspectValue
breakpointsRequired review at 390, 768, 1024 and 1440 px; execution is not implied by this declaration; columns stack under 768 px; the wrap keeps a 16 px gutter on phones.
wrappingText wraps; nothing scrolls sideways.
textExpansionJapanese runs 20 to 40% longer; headings break between phrases (jaBreaks) and blocks grow downwards.

Spacing and rhythm

AspectValue
internal--space-8 padding.
external--space-7 between panels.
rhythmOne task per panel.

Motion

AspectValue
NoneNo intrinsic element animation. The optional claude-entrance consumer profile may translate below-fold structure once (20px, --dur-weave, --ease-enter, --stagger); reduced motion disables it. This preserved baseline entrance is separate from element playback.

Runtime and reuse

  1. Render-only element; mount any registered child enhancements separately. Preserve required Site CSS, fonts, responsive and locale rules from nativeElement.

Accessibility passport

AspectValue
rolea landmark or list, as stated in its parts
nameIts visible text
keyboardLinks and buttons inside, in reading order.
focusThe --focus ring on every link and button inside.
screenReaderRead in source order; decorative weaving is aria-hidden.
contrastInk on cotton 14:1; text on every dye field 4.5:1 or better (checked by check-brand).
targetLinks and buttons are 44 px tall.

Content

SlotLengthVoice
title8 wordsThe task

Good: “How are tokens used?”

Bad: “Section 3”

Japanese: From the app's i18n tables.

Icons and illustrations

None: this element uses no icon or illustration of its own.

Decisions and exceptions

  • None.

Usage

13 uses across the built pages (measured by npm run site:system).

Tests

AspectValue
unittests/unit/site-system.test.ts: renders every do and don't example through the registry and checks the classes it owns
visualNot yet: there are no screenshot baselines; the Library page is checked for sideways scroll at 1440 px by tests/site/system.spec.ts
a11ytests/site/system.spec.ts: axe (0 serious or critical) on the element's Library page in light and dark
parityscripts/site/system/check.ts: Library examples are rendered by the same render function the site imports

Figma

not-yet: The Loom Site Figma library is the last stage of the plan; this element is not mapped yet.

Open in Storybook

Start with a conversation about your system.

We read your system, show you what we found, and agree with your team what to fix first.