Skip to content
Becoming a design system designer

Part 14 of 14 · · 5 min read

A glossary of design system terms

Plain definitions of the terms used across this series: tokens, modes, variants, governance, semver, easing, container queries, design QA, HEART and STAR.

Design system work has its own vocabulary, and most of it is simpler than it sounds. This glossary collects the terms used across the series, grouped by topic, each with a short plain definition. Use it as a reference when a word in a job description, a design review or an interview isn’t quite clear.

Foundations and tokens

TermMeaning
Design systemThe shared tokens, components, patterns, guidelines and governance a team uses to build its interface, kept in sync between design and code.
Design tokenA named value that stores one design decision, such as a colour, a spacing step or a radius. Design and code both refer to the name instead of the raw value.
Primitive tokenA raw value with a descriptive name, such as blue-600 or space-4. It says what the value is, not where to use it.
Semantic tokenAn alias that points to a primitive and names its purpose, such as color.bg.brand or color.text.danger. Themes change by remapping this tier.
Component tokenA token scoped to one component, such as button.primary.bg, usually pointing to a semantic token.
Atomic DesignBrad Frost’s model for building interfaces from small parts up: atoms, molecules, organisms, templates and pages.

Figma

TermMeaning
VariableFigma’s way of storing a reusable value, such as a colour or a number, that layers can be bound to. It is how tokens live in Figma.
ModeA set of alternative values for the same variables, such as Light and Dark. Switching the mode switches every bound value at once.
Main componentThe source definition of a component. Changes to it flow to every copy.
InstanceA linked copy of a main component placed in a design. It updates when the main component changes.
DetachBreaking an instance’s link to its main component. The layer stops receiving updates and becomes a one-off.
VariantOne version of a component within a set, such as a primary or secondary button, or a hover state.
Component propertyA setting on a component that changes content without a new variant, such as a text label, a boolean that shows an icon, or an instance swap.
SlotA placeholder inside a component where other content can be placed, like children in code.
Auto LayoutFigma’s layout system for stacking and spacing layers automatically. It works much like CSS Flexbox.
Code ConnectA Figma feature that links a design component to its real code component, so developers see the actual code snippet.

Governance

TermMeaning
GovernanceThe rules for how the system is run, changed and maintained: who decides, how changes are proposed and how they ship.
Contribution modelThe process that lets people outside the core team propose and add new components or changes to the system.
SemverSemantic versioning: version numbers in the form MAJOR.MINOR.PATCH. A major bump means breaking changes, a minor bump adds features, a patch fixes bugs.
Breaking changeA change that forces teams using the system to update their own work, such as renaming a prop or removing a variant.
DeprecationMarking something as on its way out, with a warning and a replacement, before removing it in a later version.
ChangelogA dated list of what changed in each release, written for the people who use the system.
AdoptionHow widely the system is used across products and screens.
Detach rateHow often instances of a component are detached and customised. A high rate suggests the component doesn’t meet real needs.

UX and interaction

TermMeaning
User flowThe path a person takes through screens and decisions to complete one task.
WireframeA low-detail layout of a screen that shows structure and content without visual styling.
WireflowWireframes joined by arrows, showing both the screens and how a person moves between them.
Heuristic evaluationAn expert review of an interface against a set of established usability principles, rather than testing with users.
Micro-interactionA small, single-purpose moment in an interface, such as a toggle, a like or copying to the clipboard. Dan Saffer describes it in four parts: trigger, rules, feedback, and loops and modes.
TransitionA change from one state to another, such as a colour change on hover.
EasingThe curve that describes how speed changes during a movement, such as ease-out for something entering the screen.
Reduced motionA user setting, exposed in CSS as prefers-reduced-motion, asking interfaces to minimise movement.

Accessibility and code

TermMeaning
WCAGThe Web Content Accessibility Guidelines from the W3C. Level AA is the target most teams and accessibility policies use.
Contrast ratioA measure of the difference in brightness between text and its background, used by WCAG to judge readability.
Focus-visibleThe focus outline shown when someone navigates with the keyboard. In CSS, :focus-visible shows it for keyboard users without showing it on every mouse click.
Semantic HTMLUsing the element that matches what something is, such as <button> for actions and <a> for navigation, so browsers and assistive technology understand it.
Custom propertyA CSS variable, such as --radius-md, and the usual home for design tokens in code.
Container queryA CSS rule that styles a component based on the size of its container rather than the whole viewport.
Logical propertiesCSS properties such as margin-inline-start that follow the reading direction, so layouts work in right-to-left languages.
PropsThe inputs a code component accepts, such as variant or size. They match Figma’s variants and component properties.

Quality, research and the job

TermMeaning
Design QAChecking a built feature against its design for spacing, colour, type, states and behaviour, and logging the differences.
Inconsistency auditCollecting every instance of one kind of element across a product, such as all buttons, to see how many versions exist.
Usability testingWatching real people try to complete tasks with a product, often while thinking aloud, to find where it confuses them.
Think-aloudA testing method where participants say what they are thinking as they work.
SUSThe System Usability Scale: a short, standard ten-question survey that gives a usability score.
NPSNet Promoter Score: a survey question asking how likely someone is to recommend the product.
HEARTGoogle’s framework for user-centred metrics: Happiness, Engagement, Adoption, Retention and Task success.
InsightAn observation plus the reason behind it. The reason is what points to a design change.
STARA structure for answering behavioural interview questions: Situation, Task, Action, Result.

Further reading

  • Atomic Design by Brad Frost, free to read online.
  • Design Systems by Alla Kholmatova.
  • Refactoring UI by Adam Wathan and Steve Schoger, for practical visual design.
  • Microinteractions by Dan Saffer.
  • Don’t Make Me Think by Steve Krug.
  • Nathan Curtis’s articles at EightShapes, on governance and team models.

Sources and further reading

See a design system in practice: the AppsCode Design System case study