Design System
Foundations and project specimens.
Overview
Typography
A clear voice.
Useful details. Room to read.
Label AaProposed interpretation, not design approval.
Starter tokens are proposed, not recovered brand values. Live specimens are not design approval.
Typography
Headings and body copy use the sample type scale below.
Heading scale
| Token | Value: family / weight | Value: size / leading | Sample |
|---|---|---|---|
| Display | - | - | Sample display |
| H1 | - | - | Sample heading one |
| H2 | - | - | Sample heading two |
| H3 | - | - | Sample heading three |
| H4 | - | - | Sample heading four |
| H5 | - | - | Sample heading five |
| H6 | - | - | Sample heading six |
Body text
| Token | Value: family / weight | Value: size / leading | Sample |
|---|---|---|---|
| Body large | - | - | Sample large body text. |
| Body normal | - | - | Sample body text. |
| Body small | - | - | Sample small text. |
Font pairings and type-scale trials live in the floating trial controls.
Text styles
Inline treatments for emphasis, overflow and alignment.
| Treatment | Sample |
|---|---|
| Label | Sample label |
| Caption | Sample caption |
| Emphasis | Sample emphasized text |
| Muted | Sample muted text |
| Uppercase | Sample label |
| Underlined | Sample underlined text |
Colors
Values are read from the live sample styles.
Primitives
Stored generated design choices; the subset selector never changes tokens.
Singleton primitives
| Primitive | Swatch | Value |
|---|
Semantic roles
| Role | Token | Primitive token | Swatch | Value | Used for | Evidence |
|---|
Practical usage
Contrast
Intended normal-text pairs: AA ≥ 4.5:1; AAA ≥ 7:1. Evidence describes provenance, not approval.
| Usage | Foreground role / swatch / value | Background role / swatch / value | Live sample | Ratio | AA | AAA |
|---|
Spacing
Numbered 4px scale: spacing level N is 4Npx (spacing-1 = 4px … spacing-64 = 256px). Bars use the live spacing tokens; values are read from computed styles.
| Token | Value | Example |
|---|
Micro-spacing · within components
Macro-spacing · between page regions
Grid
Custom Grid System · Bootstrap 5.3-compatible
One page grid shared by catalog and Preview. Boxes are layout diagrams, not photographs. Usable width subtracts the measured 50px desktop / 15px compact inline padding on each side; actual tracks plus gutters divide the remainder. Compositions below are spans of the same twelve tracks, not separate grid systems. Below 990px compositions stack full-span while the twelve alignment tracks remain.
Guides tint the measured columns; measurements remain in the shared table.
| Layout | Content width | Columns | Column width | Gutter |
|---|
Measured at available catalog width.
W = N × C + (N − 1) × G
Fluid tracks distribute fractional CSS pixels. Use repeat(N, minmax(0, 1fr)), not hardcoded fractional widths.
Imagery & icons
Crop ratios for photography. Every image needs descriptive alt text.
Use the project's own icon set when one exists; otherwise inline local SVG at a consistent 24px viewBox. Decorative icons are hidden from assistive tech; icon-only actions keep an accessible name.