Design system

Design rules, shown in context

Each rule pairs a correct implementation with the failure it prevents. The label shows enforcement: check:brand is an automated source check, contrast gate is the token build's WCAG check, and manual requires visual review.

Motion

One staged moment per page manual

Use one staged entrance per view. The hero may reveal; all following sections render in place.

Hero animates in. Everything else is visible from the start.

hero · id-reveal
editorial · static
grid · static

All sections fade in in turn.

section · reveal+0 ms
section · reveal+120 ms
section · reveal+240 ms

Never bounce or overshoot check:brand

Use ease-enter for arrivals. Bounce and overshoot are outside the approved motion set.

ease-enter · cubic-bezier(0, 0, 0.2, 1)

cubic-bezier(0.34, 1.56, 0.64, 1)

Never animate layout check:brand

Animating width, height, margin or padding forces repeated layout calculations. Limit transitions to the approved colour, opacity, shadow and transform properties.

class="transition duration-base ease-standard"

The approved transition set covers colour, opacity, shadow and transform. It excludes layout.

class="transition-all"

transition-all includes layout properties and can cause uneven motion.

No simulated liveness check:brand

A pulsing marker implies a live state. Use it only for a real waiting state, and keep ordinary status markers still.

3 awaiting approval

Static pointer to a true state.

Live

Pulses without representing a live state.

Pictures stand still check:brand

Zoom on hover turns the image into a button, which it is not. Feedback belongs to the container: lift, edge, shadow. The crossfade to photo number two is still legal because it shows new information instead of twisting the old.

The tile lifts; the image is at rest.

The image scales under the mouse.

Color

No purple, no gradient text check:brand

Use the approved stone, ink, red and signal roles. Create emphasis with type size and weight, not gradient text.

Emphasis with weight.

Emphasis with gradient.

Shadows have direction, never glow manual

A colored halo without offset is decoration, not depth. The system's three shadow tokens all have offset and soft blur, and are the only legal shadows.

shadow-overlay · 0 4px 16px
Neon glow around the card

Never gray text on a colored background contrast gate

Grey text on a coloured surface often falls below the contrast requirement. Use a role derived for that surface, such as accent-on-tint or inverse-muted. The contrast gate verifies each pairing.

Title on dark surface

Secondary text in the surface's own tone.

Title on dark surface

Generic grey, which neither belongs to the surface nor consists of it.

Typography

Eyebrows must carry data, otherwise they will be deleted manual

Use an eyebrow only for data such as a season, line, item number or unit. Set it in Inter, uppercase, at the overline step (D80). check:brand fails font-mono next to text-overline (overline-is-sans). Spec marks stay mono at caption size. Remove mood-setting labels.

Example data · No. 0300

The workhorse

Item number and line are data.

Welcome

Quality you can feel

"Welcome" carries nothing. Delete the line.

Reading lines of 45 to 75 characters manual

Wider than approximately 80 characters, the eye loses the line break. Body gets max-w-prose; it is not optional on text pages.

Example data: verified colour-fastness, material weight and measurement results appear here.

Example data: verified colour-fastness, material weight and measurement results appear here. Without a gap measure, the line runs the entire width of the surface, and the eye must look for the beginning of the next line.

Line spacing below 1.3 is prohibited in body text manual

Our scale has the line spacing baked in per steps (body runs 1.5). Tight line spacing only applies to the display steps, where the lines are few and short.

Example data: verified wash and certification details appear here when supplied by the approved product source.

Example data: verified wash and certification details appear here when supplied by the approved product source.

Use uppercase only for short labels check:brand

Uppercase reduces word shape and slows scanning. Headings and body copy use sentence case. Only short Inter overlines and mono spec marks use uppercase (D80).

Example format · EN ISO 20471 · Class 2

The example standard is uppercase because it is specification data.

A full paragraph in uppercase is difficult to scan.

Primary numbers take Inter, spec marks keep the mono check:brand mono-display-figure

A value you read is Inter with tabular-nums: price, quantity, count, measurement, a headline figure (D77). Overlines are Inter (D80). Mono keeps spec marks only: article, order, invoice and customer numbers, EN standards, size codes, a row index. Chivo Mono spends 0.6em on every glyph, and a percent sign wants 0.786em, so a number that carries a unit belongs on Inter. At the display step the figure follows the display face.

kr. 139,00 (kr. 111,20 ekskl. moms)

48 · 220 g/m² · 53 cm

Order 100482 · No. 0300

kr. 139,00 (kr. 111,20 ekskl. moms)

Order 100482 · No. 0300

Mono on a price, Inter on an identifier.

Never a colored stripe down one side check:brand edge-stripe

A status surface already uses a tint, status icon and status ink. A thick edge stripe repeats the same signal without adding information. Use a full hairline border such as border-status-*-border. Neutral directional borders remain valid for tabs and table rules (D51).

The cart has been updated

The cart has been updated

A standalone control is not a line of text pnpm mobile

WCAG 2.5.8 exempts links inside a sentence, but standalone links and disclosure controls need a target floor. The minimum is 24 by 24px and the target is 44 by 44px. Add hit area with padding so longer labels can wrap without pushing the viewport sideways (D50).

A scrolling table never squeezes a cell below its contents check:brand table-min-width

A w-full table inside overflow-x-auto can collapse to the container instead of scrolling. Non-wrapping cells then overlap adjacent columns. Add min-w-max so the table keeps its natural content width (D50).

The table scrolls at its natural width, and the cut column edge is the signal that there is more.

The table "fits" in width and two columns of text share the same pixels.

Functional text never under 12px check:brand type-floor

Links, labels, table cells and metadata below 12px fail on small screens and high DPI. The scale floor for reading text is body-sm at 14px; overline of 12px is the absolute bottom of the system and only for labels. Overline used to shrink to 11.5px on the phone, so less accurate where reading conditions are worst: after D50, the step is not fluid, and the measurement found 585 text nodes below the floor, all of which were the one step.

Updated August 14, 2026 · 12.5px

Updated August 14, 2026 · 9px and no one can read it on a phone

Layout

No icon tile above the header manual

Place a supporting icon beside the heading it describes. A separate icon tile adds another visual group without adding meaning.

Your cart is empty

Your cart is empty

Never card in card manual

Container within container is noise. Group with spacing and dividers instead of another frame.

Example order 4412

Example line · 160 units
Example line · 80 units

Example order 4412

Example line · 160 units

No colored border strip on card manual

Status is already carried by the tint, border and text. Do not add a thick edge stripe.

Example data: item 0324 on back order until week 38.

Stock status: stripe on the edge instead of a flat that says so.

More air above a heading than below manual

A heading binds itself to what it introduces. If it sits equally close to both neighbors, each section looks like a caption to the previous one.

…end of previous section.

Sizes and fit

The section the title belongs to.

…end of previous section.

Sizes and fit

The section heading belongs, but the air ties it to the wrong one.

Edge or shadow, never both large manual

A wide overlay shadow and a hairline border express two elevation levels at once. Use one. A subtle raised shadow may keep its border; an overlay shadow stands alone.

The edge defines the object.
Edge AND large shadow: the ghost card.

The purchase line contains one thing check:brand

Rectangles select values; pills trigger actions. Fields, size tiles and quantity steppers use radius.sm. Buttons use the pill radius. Keep quantity with the other value controls and place the action on its own row. check:brand flags a pill and rectangle at the same height in one flex row.

Number

1
Add to cart
1
Add to cart

Same height, two shape families. The controls appear inconsistent.

Two actions share a row check:brand

When two actions belong to the same moment they sit in .id-actions: a wrapping row, each pill sized to its label. Stacking them as full-width bars wastes the width and reads as a form submit. A lone commerce submit stays full-width and alone.

See the collection Book showroom
See the collection Book showroom

Two full-width pills stacked. The pair reads as a form submit and the row beside them is empty.

A tile flag is the same chip as status check:brand

D12 gave product tiles a second voice: mono overline, uppercase, a red dot. That voice is an eyebrow. On a photograph it sits beside the system. Colour still carries the meaning. The chip is the same one a table uses: rounded-badge, caption, sentence case.

Nyhed Kampagne
Nyhed

Eyebrow voice on a tile. It reads as a sticker, not as a label in this system.

One system chrome, one word list check:brand

The design-system bar is one object. The lockup is always Design system and always goes to Overview. The eight labels are Overview, Components, Layout, Rules, Type, Slides, Manual, Operations. The bar is sticky. Below lg the destinations sit behind a menu icon; Dark stays outside. Without JS the row still scrolls. Dark is a rectangle. The page title lives in the H1.

Design system

Overview · Components · Layout · Rules · Type · Slides · Manual · Operations

Dark

Component gallery as the lockup

Type and colour in one bar, Specimens in search, a different home on the rulebook.

Dark

Burger below lg check:brand

Eight destinations do not fit a 320 bar. The menu icon opens a panel. Dark stays on the bar. The control is a rectangle, same family as Dark.

Design system

Dark

Design system

Overview Components Layout Rules Type Sli

The row scrolls sideways and hides the current page.

Details

The browser's own surfaces are also design manual

Selection colour, caret, focus ring and tabular numerals are part of the interface. Apply the system roles instead of leaving unrelated browser defaults.

Select this sentence with the mouse and see the selection color come from the palette.

4,820 · 3,470 · 2,640 · numbers in column

Standard blue marking, black caret and proportional numbers in a table: three little proofs that no one was looking.

A field says what it is or that it is nothing check:brand

Every text-like field needs an explicit autocomplete value. Browsers, password managers and mobile keyboards use it to identify the field. Use autocomplete="off" for values that must not be reused, such as a requisition number.

<input name="CustomerZip" type="text" required
       autocomplete="postal-code" inputmode="numeric"
       pattern="[0-9]{4}" maxlength="4">

<input name="CustomerReference" type="text"
       autocomplete="off">
<input name="CustomerZip" type="text" required>

<input name="CustomerReference" type="text">

The fields look complete, but the browser cannot identify them or offer the correct input support.

The total is found in one place manual

The order total appears in the summary, submit button and confirmation. Read all three from one server-calculated value so they cannot diverge. The amounts below are example data.

string orderTotal = "kr. 17.938,25";
…
<button>Place order, @orderTotal</button>
<button>Place order, kr. 15.642,00</button>
…
<td>kr. 17.938,25</td>

Two states that are similar to each other are one state manual

The low-stock and sold-out markers measured 4.4 apart in OKLab, below the system floor of 8 for adjacent marks. Use shape as well as colour: sold out uses a hollow ring, while low stock uses a solid dot. The distinction also works in greyscale.

Low stock

Sold out

Back order

Low stock

Sold out

Back order

width and height are the dimensions of the file, not the one shown check:brand

The browser uses width and height to reserve the image's aspect ratio before the file arrives, so both attributes must use the source file dimensions. Every image also needs an explicit alt and loading decision. The responsive sizes, width ladder and weight budget are documented in foundations/image-contract.md.

<img src="…/0300.webp"
     alt="Example T-shirt, navy, front view"
     width="800" height="867"
     loading="eager" fetchpriority="high">

Source file dimensions, descriptive alt text and one eager LCP image.

<img src="…/0300.webp"
     alt=""
     width="900" height="1200">

Rendered dimensions, empty alt text on the main image and no loading decision.

Wait is not the same as disable check:brand

A disabled submit button is omitted from form data, including the name and value DynamicWeb uses for the cart command. Use aria-busy while submitting so the command still posts and assistive technology receives the waiting state. Reserve disabled for an action that is genuinely unavailable.

<button type="submit" name="CartCmd" value="add"
        aria-busy="true">
<button type="submit" name="CartCmd" value="add"
        disabled>   <!-- CartCmd was never submitted -->

A skeleton has the shape of what is to come manual

A placeholder with the wrong dimensions postpones the layout shift instead of preventing it. Match the real component's 3:4 image and text rows rather than using one generic rectangle.

3:4 image, three lines of text, same box as the product card.

One rectangle with the wrong aspect ratio. The layout shifts when the card arrives.

An icon is mentioned, it is never drawn check:brand

The difference is not seen on the screen, it is seen in the source, so here is the source. Before the rule, there were 117 hand-inserted SVGs in the repo, drawn by 37 different shapes: the forward arrow 19 times, the chevron 21, and three copies of the same tick with three different stroke weights. The set is governed in icons/icons.json, and the classes are generated from there.

View the full range

<span class="id-icon id-icon-arrow-right"></span>

View the full range

<svg class="h-icon-sm w-icon-sm" viewBox="0 0 24 24"
     fill="none" stroke="currentColor" stroke-width="2"
     stroke-linecap="round" stroke-linejoin="round"
     aria-hidden="true">
  <path d="M5 12h14"/><path d="m12 5 7 7-7 7"/>
</svg>

Remove unsupported buzzwords check:brand

Generic promises do not help a buyer compare products. Use verified specifications and concrete actions.

Example data: 175 g/m². Example wash requirement: 60°C. Size range: S to 6XL.

A ground-breaking, problem-free experience in a class of its own, which strengthens your brand.

Product grids sit as a field check:brand

D12 asked for taller row gaps so the category page felt like a lookbook. A workwear catalogue is scanned. .id-card-grid keeps 2/3/4 columns and sets the gutters to 8 px across and 24 px down. Restating gap-y-14 next to a listing is how the density splits between the category, search, and the PDP related row.

PRO Wear T-shirt

T-TIME® T-shirt

PRO Wear T-shirt

T-TIME® T-shirt

Documented exceptions

The decision log records three deliberate exceptions to the general rules. Apply them only within the stated scope.

The warm cream surface remains (D11)

The warm cream surface is an approved brand decision recorded in D8 to D11. Do not substitute another neutral without a token decision.

Stats bands and agenda numbers remain within defined rules (D9, D13)

Stats bands may present verified measurements, and agenda numbers may represent a real sequence. A number without an approved source or sequence remains prohibited.

Product photo crossfade remains (D9)

Pictures are still, but the crossfade between photo one and two shows a new angle of the item. It is information, not movement for movement's sake. Scaling and rotation remain prohibited.