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.
--wa-color-brand--wa-color-neutral--wa-color-success--wa-color-warning--wa-color-dangerBrand tint ramp¶
The ramp below uses --wa-color-brand-20 through --wa-color-brand-95. Numeric tint names identify tokens, not measured contrast ratios.
2040608095The 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.
--wa-font-size-3xl--wa-font-size-2xl--wa-font-size-l--wa-font-size-m--wa-font-size-s--wa-font-family-code4. 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-2xl5. Border radii and shadows¶
Radius¶
--wa-border-radius-s--wa-border-radius-m--wa-border-radius-l--wa-border-radius-pillElevation¶
--wa-shadow-s--wa-shadow-m--wa-shadow-l6. 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.
Card contents inherit the active theme and use the existing wa-card slot and elevation rules.
Illustrative success state. Status meaning is also conveyed in words, not only by color.
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¶
The essential samples are static HTML and CSS; they remain readable with JavaScript disabled and in printed or exported text form.
Never rely on color alone for state; pair each variant with a name or other visible text. Use
--wa-color-{variant}-onfor foreground text on the corresponding core fill rather than guessing a contrasting hex value.Theme previews use local
wa-light/wa-darkscopes; they must not update the<html>element or write browser storage.The project pins the Web Awesome version in package.json. Styles are supplied through the existing self-hosted build pipeline, including prefixed locale routes.
For canonical definitions, see Web Awesome’s colors, typography, space, borders, and shadows references.