Skip to article frontmatterSkip to article content
Site not loading correctly?

This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

Design Tokens & Style Preview

This page visualizes the self-hosted Web Awesome 3.14.0 design tokens used by the SoftCloud documentation theme. Every color, spacing measurement, radius, and shadow below is drawn from a CSS custom property, not a separate palette of fixed sample colors.

The visual samples are illustrative UI, not live infrastructure telemetry. The color and layout previews render as ordinary HTML/CSS without JavaScript; the examples of wa-button, wa-card, and wa-callout use the existing typed Lit SSR directives.

Back to the Web Awesome notebook · Design token reference · Component catalog · Official Web Awesome design tokens

1. Themed interface previews

The two samples explicitly scope wa-light and wa-dark to individual sections. They appear side by side regardless of the reader’s currently selected site theme and do not modify the global MyST theme.

2. Semantic color variants

Web Awesome defines five semantic variants. The color patch uses the matched core color and its -on foreground token, so the swatch label is readable even when a hue is changed by the theme.

Aa
Brand Primary actions --wa-color-brand
Aa
Neutral Secondary UI --wa-color-neutral
Aa
Success Confirmed outcomes --wa-color-success
Aa
Warning Caution --wa-color-warning
Aa
Danger Errors and risk --wa-color-danger

Brand tint ramp

The ramp below uses --wa-color-brand-20 through --wa-color-brand-95. Numeric tint names identify tokens, not measured contrast ratios.

20
40
60
80
95

The available numeric tints are 05, 10, 20, 30, 40, 50, 60, 70, 80, 90, and 95. The current palette and theme determine the rendered color.

3. Typography

Text samples inherit the installed Web Awesome font families, sizes, weights, and line heights. A publication’s MyST typography can differ from a Web Awesome component’s typography; this is a reference for the latter.

Interface heading--wa-font-size-3xl
Section heading--wa-font-size-2xl
Supporting heading--wa-font-size-l
Body copy — Sphinx of black quartz, judge my vow.--wa-font-size-m
Secondary labels and supporting details--wa-font-size-s
kubectl get nodes -o wide--wa-font-family-code

4. Spacing

Each bar is exactly three times the named spacing token so the progression is visible; its width updates automatically if --wa-space-scale changes.

--wa-space-2xs
--wa-space-xs
--wa-space-s
--wa-space-m
--wa-space-l
--wa-space-xl
--wa-space-2xl

5. Border radii and shadows

Radius

Small--wa-border-radius-s
Medium--wa-border-radius-m
Large--wa-border-radius-l
Pill--wa-border-radius-pill

Elevation

Small--wa-shadow-s
Medium--wa-shadow-m
Large--wa-shadow-l

6. Components with real Web Awesome styling

These are the existing typed SSR primitives, not synthetic CSS reproductions of Web Awesome components. The explanatory content and copyable code remain available without client JavaScript.

Token-aware surface

Card contents inherit the active theme and use the existing wa-card slot and elevation rules.

Card reference

Open token reference

Read theming guide

7. Reusable source snippet

The following is standalone example markup. It uses Web Awesome’s public CSS custom properties and does not depend on Shadow DOM internals, JavaScript, Tailwind, or absolute deployment paths.

<section class="wa-light" aria-label="Example status card">
  <div class="token-example">
    <strong>Documented surface</strong>
    <p>Theme-responsive content with semantic colors.</p>
  </div>
</section>
.token-example {
  padding: var(--wa-space-l);
  border: var(--wa-border-width-s) var(--wa-border-style) var(--wa-color-surface-border);
  border-radius: var(--wa-border-radius-l);
  box-shadow: var(--wa-shadow-s);
  background: var(--wa-color-surface-raised);
  color: var(--wa-color-text-normal);
  font: var(--wa-font-weight-body) var(--wa-font-size-m) / var(--wa-line-height-normal)
    var(--wa-font-family-body);
}

Accessibility, rendering and source of truth