Nord Design System provides 129+ accessible, production-ready Lit web components (<nord-*> prefix), design tokens (CSS custom properties), Tailwind CSS v4 integration, two brands (therapy/veterinary) with dark mode and high-contrast variants. Framework-agnostic — works with React, Vue, Angular, Svelte, plain HTML.
Components
| Component | Description | Reference |
|---|
| Web Components Overview | All component APIs, slots, and events | components |
| nord-accordion | Accordion is a set of collapsible sections, each with a header that toggles the visibility of its content. | accordion |
| nord-accordion-header | Accordion Header is the heading that labels an Accordion Panel. | accordion-header |
| nord-accordion-item | Accordion Item groups an Accordion Header and its Accordion Panel within an Accordion. | accordion-item |
| nord-accordion-panel | Accordion Panel holds the content revealed by its Accordion Trigger. | accordion-panel |
| nord-accordion-trigger | Accordion Trigger is the button that opens and closes its Accordion Panel. | accordion-trigger |
| nord-aside | Container for the right-side rail + drawer pattern in the app shell. | aside |
| nord-aside-drawer | A drawer panel inside <nord-aside>. | aside-drawer |
| nord-aside-trigger | Rail button that toggles a <nord-aside-drawer> inside <nord-aside>, or navigates like a link when href is set. | aside-trigger |
| nord-autocomplete | Autocomplete is a free-text input with suggestions: the text the user types is itself the committed value (a string), and the options are completion aids. | autocomplete |
| nord-avatar | Avatar is used for showing a thumbnail representation of a single user or entity. | avatar |
| nord-badge | Badges are used to inform users of the status of an object or of an action that’s been taken. | badge |
| nord-banner | Banner informs users about important changes or conditions in the interface. | banner |
| nord-button | Buttons are used for interface actions. | button |
| nord-button-group | Button groups are designed to bring together button controls that are of a similar nature. | button-group |
| nord-calendar | Calendar allows user to pick a date. | calendar |
| nord-card | Cards are shadowed surfaces that display content and actions on a single topic. | card |
| nord-card-body | The main content region of a composed Card. | card-body |
| nord-card-footer | The footer region of a composed Card. | card-footer |
| nord-card-header | The header region of a composed Card. | card-header |
| nord-checkbox | Checkboxes allow user to choose one or more options from a limited set of options. | checkbox |
| nord-collapsible | Collapsible is a disclosure that shows or hides a section of content. | collapsible |
| nord-collapsible-panel | Collapsible Panel holds the content revealed by its Collapsible Trigger. | collapsible-panel |
| nord-collapsible-trigger | Collapsible Trigger is the interactive control that opens and closes its Collapsible panel. | collapsible-trigger |
| nord-combobox | Combobox lets users choose one option (or several) from a list by typing to filter, then picking with the keyboard or pointer. | combobox |
| nord-combobox-group | Groups declarative <nord-combobox-option> children under a heading inside a Combobox: html <nord-combobox> <nord-combobox-group label="Frameworks"> <nord-combobox-option value="next">Next.js</nord-combobox-option> </nord-combobox-group> </nord-combobox> Contained options inherit this label as their group. | combobox-group |
| nord-combobox-option | A declarative option for a Combobox. | combobox-option |
| nord-command-menu | Command Menu allows users to navigate and use an app without touching the mouse and helps them transform into “power users” who can harness more advanced features far faster. | command-menu |
| nord-date-picker | Date Picker allows user to enter a date either through text input, or by choosing a date from the calendar. | date-picker |
| nord-date-range-picker | Date Range Picker lets people choose a start and end date as a single range, either from a built-in list of presets (Today, Last 7 days, This month, …) or from a range calendar. | date-range-picker |
| nord-divider | Divider components are used to separate and distinguish sections of content or groups of menu items. | divider |
| nord-drawer | Drawer is used to display context-sensitive actions and information. | drawer |
| nord-drawer-body | The main content region of a composed Drawer. | drawer-body |
| nord-drawer-close | A standalone close control for a composed Drawer. | drawer-close |
| nord-drawer-footer | The footer region of a composed Drawer. | drawer-footer |
| nord-drawer-header | The header region of a composed Drawer. | drawer-header |
| nord-dropdown | Dropdown menu displays a list of actions or selectable options for a user. | dropdown |
| nord-dropdown-group | Dropdown group includes all the actions or items in a single dropdown group and is used for grouping items into related categories. | dropdown-group |
| nord-dropdown-item | Dropdown item populates dropdown with actions. | dropdown-item |
| nord-dropdown-submenu | Dropdown submenu nests a secondary menu within a parent dropdown. | dropdown-submenu |
| nord-empty-state | Empty state can be used when there is no data to display to describe what the user can do next. | empty-state |
| nord-field | Field is the wrapper for a single form control. | field |
| nord-field-content | Field Content wraps a Field Label and Field Description so they stay aligned as a single text block, which is especially useful in horizontal Field layouts. | field-content |
| nord-field-description | Field Description is the helper or hint text for a Field. | field-description |
| nord-field-error | Field Error displays validation error text for a Field. | field-error |
| nord-field-group | Field Group stacks a set of Field controls vertically with consistent spacing. | field-group |
| nord-field-label | Field Label is the label for a control inside a Field. | field-label |
| nord-field-legend | Field Legend labels a Field Set, naming the group of fields for assistive technology. | field-legend |
| nord-field-separator | Field Separator draws a thin divider between sections inside a Field Group. | field-separator |
| nord-field-set | Field Set groups related fields under a Field Legend for semantic, accessible grouping. | field-set |
| nord-field-title | Field Title is an emphasized inline title used inside choice-card style Field layouts, where a Field Label wraps a whole selectable field. | field-title |
| nord-fieldset | Deprecated: for new code, group related controls with the composable Field family — see grouping fields with Field. | fieldset |
| nord-footer | The footer is a block of designated space for providing additional information or actions that are positioned below the main content. | footer |
| nord-header | The header is a block of designated space for labelling the currently viewed context as well as providing primary actions. | header |
| nord-icon | Icons are used to provide additional meaning or in places where text label doesn’t fit. | icon |
| nord-input | Inputs are used to allow users to provide text input when the expected input is short. | input |
| nord-input-group | Input Group composes exactly one Nord Input or Textarea with reusable add-ons while leaving the editable control, form state, and all consumer nodes owned by the consumer. | input-group |
| nord-input-group-addon | Positions reusable Nord content around the text control in an Input Group. | input-group-addon |
| nord-item | Item is a flexible, composable row used to display a piece of content such as a person, a file or a setting. | item |
| nord-item-actions | Item Actions holds the trailing controls of an Item, such as buttons or a chevron. | item-actions |
| nord-item-content | Item Content holds the textual content of an Item, typically an Item Title and an Item Description. | item-content |
| nord-item-description | Item Description is the secondary, muted line of text in an Item. | item-description |
| nord-item-footer | Item Footer spans the full width at the bottom of an Item, useful for a row of metadata or trailing actions. | item-footer |
| nord-item-group | Item Group stacks a set of Item rows vertically and exposes them to assistive technology as a list. | item-group |
| nord-item-header | Item Header spans the full width at the top of an Item, useful for a leading image or a row of metadata. | item-header |
| nord-item-media | Item Media holds the leading visual of an Item, such as an icon, an avatar or an image. | item-media |
| nord-item-separator | Item Separator draws a horizontal divider between Item rows inside an Item Group. | item-separator |
| nord-item-title | Item Title is the primary line of text in an Item. | item-title |
| nord-kbd | Kbd is used to display a keyboard key, such as a shortcut or a key the user should press. | kbd |
| nord-kbd-group | Kbd Group lays out a set of Kbd keys together, for example to represent a multi-key shortcut such as <kbd>Ctrl</kbd> <kbd>K</kbd>. | kbd-group |
| nord-layout | Layout component is used to create the main layout of an app. | layout |
| nord-message | Message represents a specific item within a collection, such as notifications, tasks or conversations. | message |
| nord-meter | Meter is a graphical display of a numeric value within a known range, such as disk usage, a battery level or a score. | meter |
| nord-modal | Modal component is used to display content that temporarily blocks interactions with the main view of an application. | modal |
| nord-modal-body | The main content region of a composed Modal. | modal-body |
| nord-modal-close | A standalone close control for a composed Modal. | modal-close |
| nord-modal-footer | The footer region of a composed Modal. | modal-footer |
| nord-modal-header | The header region of a composed Modal. | modal-header |
| nord-nav-group | Navigation group includes all the actions or items in a single group and is used for grouping items into related categories. | nav-group |
| nord-nav-item | Navigation item populates sidebar navigation with links. | nav-item |
| nord-nav-toggle | Nav toggle hides and shows the primary navigation inside <nord-layout>. | nav-toggle |
| nord-navigation | Navigation is used to display the primary navigation in the sidebar of an application. | navigation |
| nord-notification | Notifications provide important information that requires action or acknowledgement. | notification |
| nord-notification-group | Notification group is used to position and style a group of notifications. | notification-group |
| nord-number-field | Number Field is a control for entering a numeric value, with decrement and increment stepper buttons, optional drag-to-scrub, and locale-aware formatting. | number-field |
| nord-otp-field | OTP Field is a segmented one-time-code input: it renders length individual character cells plus a visually-hidden input that holds the full value, enabling SMS / keychain autofill and native pattern/required validation. | otp-field |
| nord-outline | Outline is an in-page table of contents that lists a page's headings and highlights the section currently in view as you scroll. | outline |
| nord-outline-item | Outline Item is a single link within an Outline. | outline-item |
| nord-overflow-list | Overflow List shows the contiguous set of direct child items that fits in the available inline size and exposes the remaining items to a consumer-owned overflow affordance. | overflow-list |
| nord-overflow-list-count | Displays the number of items currently hidden by the nearest Overflow List. | overflow-list-count |
| nord-overflow-list-menu | Provides a declarative menu for actions hidden by the nearest Overflow List. | overflow-list-menu |
| nord-pagination | Pagination is the navigation root for a paginated collection. | pagination |
| nord-pagination-content | The list container for composed Pagination controls. | pagination-content |
| nord-pagination-ellipsis | The collapsed-pages marker (…) in a composed Pagination. | pagination-ellipsis |
| nord-pagination-item | A single slot in a composed Pagination Content row. | pagination-item |
| nord-pagination-link | A page link in a composed Pagination. | pagination-link |
| nord-pagination-next | The "next page" control in a composed Pagination. | pagination-next |
| nord-pagination-previous | The "previous page" control in a composed Pagination. | pagination-previous |
| nord-popout | Popouts are small overlays that open on demand. | popout |
| nord-progress | Progress component is used to display a circular pie-chart style progress indicator. | progress |
| nord-progress-bar | Progress Bar is used to visually represent the completion of a task or process. | progress-bar |
| nord-qrcode | QR Code component is used for providing information or links to users which they can quickly scan with their smartphone. | qrcode |
| nord-radio | Radio buttons are graphical user interface elements that allow user to choose only one option from a predefined set of mutually exclusive options. | radio |
| nord-range | Range input lets user specify a numeric value using a slider which must be no less than a given value, and no more than another given value. | range |
| nord-resizable | Resizable coordinates an alternating sequence of panels and handles using immutable percentage layouts and native pointer/keyboard interactions. | resizable |
| nord-resizable-handle | Resizable Handle is an accessible window splitter placed between two direct Resizable Panels. | resizable-handle |
| nord-resizable-panel | Resizable Panel contains consumer-owned content whose percentage size is coordinated by its direct Resizable parent. | resizable-panel |
| nord-scroll-area | Scroll Area is a container that wraps overflowing content in a custom scroll viewport with consistently-styled scrollbars. | scroll-area |
| nord-segmented-control | Segmented control is used to pick one choice from a set of closely related choices, and immediately apply that selection. | segmented-control |
| nord-segmented-control-item | Segmented control items populate a segmented control with options. | segmented-control-item |
| nord-select | Select lets users choose one option from an options menu. | select |
| nord-skeleton | Skeletons are used to provide a low fidelity representation of content before it appears in a view. | skeleton |
| nord-spinner | Spinner component is used to indicate users that their action is being processed. | spinner |
| nord-stack | Stack component manages layout of immediate children along the vertical or horizontal axis with optional spacing between each child. | stack |
| nord-tab | The interactive tab button for use within the tab group component. | tab |
| nord-tab-group | Tab Group allows multiple panels to be contained within a single window, using tabs as a navigational element. | tab-group |
| nord-tab-panel | The panel which contains content that can be revealed using a tab in the tab group component. | tab-panel |
| nord-table | Table is used to organize and display information from a data set. | table |
| nord-tag | Tags represent a set of keywords that help label, categorize, and organize objects. | tag |
| nord-tag-group | Tag groups are designed to bring together selectable tags that are of a similar nature. | tag-group |
| nord-textarea | Textarea is a component that allows user to write text over multiple rows. | textarea |
| nord-time-picker | Time Picker pairs the browser's native time field with a dropdown of quick options, generated at a configurable interval between start and end. | time-picker |
| nord-timestamp | Timestamp presents an instant as localized, stable system, relative, or automatically selected text while retaining native date-time semantics. | timestamp |
| nord-toast | Toasts are non-disruptive messages that appear in the interface to provide quick, at-a-glance feedback on the outcome of an action. | toast |
| nord-toast-group | Toast group is used to position and style a group of toasts, whilst ensuring they are announced by screen readers. | toast-group |
| nord-toggle | Toggle switch gives control over a feature or option that can be turned on or off. | toggle |
| nord-tooltip | Tooltips are floating containers for displaying additional information for the currently focused element. | tooltip |
| nord-top-bar | Top bar is a header component that is always visible at the top of the interface. | top-bar |
| nord-truncate | Truncate clips text with a single- or multi-line ellipsis and reveals a tooltip with the full text when the content overflows. | truncate |
| nord-visually-hidden | Visually hidden is used when an element needs to be available to assistive technologies like screen readers, but be otherwise hidden. | visually-hidden |
Design Guidelines
| Topic | Description | Reference |
|---|
| Accessibility | WCAG compliance checklist, ARIA patterns, keyboard navigation | accessibility-checklist |
| Colour System | Colour tokens, palette, semantic colour usage | colors |
| Colour Utilities | CSS colour utility classes | color-utilities |
| CDN | CDN setup for components, CSS, fonts, icons | cdn |
| Grid | Layout grid system, responsive breakpoints | grid |
| Iconography | Icon usage, custom icons, Nordicons integration | iconography |
| Localisation | RTL support, translation patterns | localization |
| Naming | Component and token naming conventions | naming |
| Typography | Font stacks, type scale, text utilities | typography |
| Web Components | Lit web component patterns, lifecycle, slots, events | web-components |
| Webfonts | Font loading, self-hosting, CDN fonts | webfonts |
Design Tokens
| Topic | Description | Reference |
|---|
| Design Tokens | CSS custom properties for colour, spacing, typography, elevation | tokens |
CSS Framework
| Topic | Description | Reference |
|---|
| CSS Overview | Nord CSS framework, utility classes, reset styles | css |
| Tailwind CSS | Tailwind CSS v4 integration, n: variant prefix, theme config | css/tailwind |
| ESLint Plugin | Linting rules for Nord CSS conventions | css/eslint |
Nordicons
| Topic | Description | Reference |
|---|
| Nordicons | Icon library, available icons, usage patterns | nordicons |
Themes
| Topic | Description | Reference |
|---|
| Themes | Therapy/veterinary brands, dark mode, high contrast variants | themes |
Migration Guides
| Topic | Description | Reference |
|---|
| Migration Guides | Version upgrade guides, breaking changes | migrations |