NS DESIGN.md

Overview

Visual Theme & Atmosphere

NS "connects people across the Netherlands and beyond", aiming "to make travel as comfortable, reliable and sustainable as possible, from door to door" by train, bus, bicycle and other transport. Its online channels belong to NS Group N.V. Its history page traces the Dutch railway from the first train through the war years and corporatisation to "a modern NS: focused on you".

ns.nl wears the railway's colours: NS yellow #ffc917 and deep blue #003082 — the text colour itself is that blue — with a working blue #0063d3 for the journey planner, white cards on #f7f7f9, and NS Sans throughout.

What makes it worth reading:

• A three-tier token system. --nes-core-* primitives, --nes-base-* roles (brand-primary-default, content-text-default, system-critical-pale) and --nes-applied-* context tokens (applied-form, applied-interaction, applied-modality).
• Transport modes as tokens. --nes-applied-modality-color-shared-bike #1e7bbc, -shared-car #11872f, -parking #28549c, -own-transport #00819e — the planner's legend.
• A flood hover. Buttons carry a 2px darker bottom edge that fills the whole button on hover (inset 0 -2px → inset 0 -50px).

Primary tasks

• Plan a journey; buy a ticket.
• Check travel information and disruptions.

Brand Narrative

NS's yellow and blue, carried into a planner-first site: blue text everywhere, yellow for buying, a working blue for planning, and a token system that knows about bikes, cars and parking as well as trains.

Principles

• Door to door. The stated goal.
• Blue is the text colour.
• Buttons you can feel. A bottom edge that floods on hover.

Personas

Not researched. No persona claim is made from a UI capture.

Colors

Measured with getComputedStyle on ns.nl: 535 root custom properties — --nes-* 496 (core colour 123, base colour 85, fonts, dimensions, motion …) and --cc-* 38 (cookie consent). All first-party.

Brand

• Brand yellow (#ffc917) — --nes-base-color-brand-primary-default.
• Yellow shade (#ffb519) — the yellow button's bottom edge and hover.
• Yellow strong (#8a6000) · Yellow pale (#fcf6e8).
• Brand blue (#003082) — brand-secondary-default, content-text-default, text-logo.
• Blue subdued (#193370).

Action blue

• Action blue (#0063d3) — brand-tertiary-default, applied-interaction-color-active.
• Action shade (#004ba0) — the planner button's edge and hover.
• Action subdued (#1f55b2) — applied-interaction-color-active-pressed.

Text, surfaces and lines

• Foreground (#003082) · Text strong (#252528) · Text subdued (#404144) · Text subtle (#75767c).
• Canvas (#ffffff) · Background base (#f7f7f9).
• Border (#e4e5e8) · Border strong (#93949a).

System

Success #008672 · Critical #e2103d · Attention #d44504 · Highlight #7b55cd.

Typography

Font family

NS Sans (400, 700), "NS Sans", "Segoe UI", Myriad, Verdana, sans-serif, loaded (document.fonts).

Scale

Main navigation 18px/700; buttons and forms 16px/400; secondary navigation 14px/400.

Layout

• A white header with bold blue navigation, a journey planner card, then yellow and blue promo blocks on #f7f7f9.

Responsive Behavior

Not measured. Desktop 1440×1000 only.

Elevation & Depth

Buttons carry a 2px inset bottom edge; focus rings add a soft 28px shadow.

Motion & Easing

Not measured.

Tier 1 sources: https://www.ns.nl/ (live homepage — 535 root custom properties read via getComputedStyle; NS Sans loaded; four components measured at rest, hover, pressed and focus, captured 2026-09-26); https://www.ns.nl/zz-this-does-not-exist (nonsense-path control — HTTP 404 in the browser, read 2026-09-26); https://www.ns.nl/en/about-ns (About NS — connecting people across the Netherlands, door-to-door goal; online channels of NS Group N.V., read 2026-09-26); https://www.ns.nl/en/about-ns/learning-about-ns/history (History of NS, read 2026-09-26)

Components

Measured with focus under a real Tab key and a hover counted only when :hover matched; consent rejected.

• Plan button — Plannen: #0063d3, white, 4px, 45px, with inset 0 -2px 0 #004ba0. Hover and press flood it with #004ba0 (inset 0 -50px); focus a 1px dotted outline.
• Yellow button — Koop nu: #ffc917, #003082 text, #ffb519 edge flooding on hover.
• Outline button — Bestel treinkaartje: blue text, a faint border that turns #003082 on hover and press.
• Header link — Zakelijk, In English: #003082 14px. Hover adds a yellow #ffc917 bar (::after); focus a #0063d3 ring on ::before.

Radius

4px on buttons and inputs.

States

Hover: buttons flood with their edge colour; outlines turn solid blue; header links gain a yellow bar. Press: the same. Focus: 1px dotted outlines on buttons; a #0063d3 ring on links.

Do's and Don'ts

Do

• Pair NS yellow #ffc917 with NS blue #003082; set text in that blue.
• Give buttons a darker 2px bottom edge that floods on hover.
• Use the modality tokens for transport legends.

Don't

• Don't put white text on yellow; the pairing is blue on yellow.
• Don't use black body text; NS text is blue.
• Don't mix the working blue #0063d3 with the brand blue for body copy.

Voice & Tone

Not assessed as authored voice.

Agent Prompt Guide

Quick Color Reference

#ffc917 NS yellow · #003082 NS blue · #0063d3 action blue · #004ba0 action shade · #ffb519 yellow shade · #252528 strong · #f7f7f9 base · #e4e5e8 border

Example Component Prompts

• "A 45px #0063d3 button, white 16px NS Sans, 4px radius, a 2px #004ba0 inset bottom edge that fills the button on hover."
• "A yellow #ffc917 button with #003082 text and a #ffb519 edge."

Governance

Known Gaps

• Contrast, button-outline. Text #003082 on #00000000 measures 1.75:1, below the WCAG AA 4.5:1 minimum for normal-size text. Recorded as measured, not adjusted.
• Contrast, link-header. Text #003082 on #00000000 measures 1.75:1, below the WCAG AA 4.5:1 minimum for normal-size text. Recorded as measured, not adjusted.