Skip to content

3lvia/designsystem / skills/elvia-design-system

elvia-design-system

Verified

Reference for UI components and patterns in Elvia's design system ("Elvis"). Covers component- and pattern-specific guidelines for sizing, color tokens for custom UI, types, ordering, labeling, accessibility attributes, CSS setup, and web-component registration. Use when building, reviewing, or fixing UI in an Elvia frontend, even if the request doesn't name Elvia or the CSS classes explicitly (e.g. "add a save button", "make this icon bigger", "add a tooltip").

FileKindSize
README.mdmarkdown726 B
SKILL.mdskill md10.4 KB
references/accordion.mdmarkdown5.9 KB
references/alert.mdmarkdown4.3 KB
references/app-bridge.mdmarkdown3.3 KB
references/autocomplete.mdmarkdown5.5 KB
references/badge.mdmarkdown2.3 KB
references/box.mdmarkdown2.0 KB
references/breadcrumb.mdmarkdown2.9 KB
references/button.mdmarkdown6.0 KB
references/card.mdmarkdown5.6 KB
references/carousel.mdmarkdown4.4 KB
references/checkbox.mdmarkdown4.7 KB
references/chip.mdmarkdown4.1 KB
references/color-tokens.mdmarkdown5.6 KB
references/content-loader.mdmarkdown2.0 KB
references/context-menu.mdmarkdown6.6 KB
references/data-formats.mdmarkdown2.1 KB
references/datepicker-range.mdmarkdown5.4 KB
references/datepicker.mdmarkdown6.0 KB
references/divider.mdmarkdown2.4 KB
references/drag-and-drop.mdmarkdown2.0 KB
references/dropdown.mdmarkdown6.7 KB
references/empty-state.mdmarkdown3.0 KB
references/file-upload.mdmarkdown2.6 KB
references/form-field.mdmarkdown2.7 KB
references/header.mdmarkdown5.8 KB
references/icon.mdmarkdown5.0 KB
references/illustrations.mdmarkdown1.4 KB
references/input.mdmarkdown2.5 KB
references/installation.mdmarkdown2.1 KB
references/link.mdmarkdown3.3 KB
references/list.mdmarkdown2.0 KB
references/modal.mdmarkdown6.1 KB
references/pagination.mdmarkdown4.0 KB
references/popover.mdmarkdown5.3 KB
references/progress-linear.mdmarkdown3.1 KB
references/radio-button.mdmarkdown2.6 KB
references/radio-filter.mdmarkdown2.8 KB
references/search-pattern.mdmarkdown2.7 KB
references/segmented-control.mdmarkdown3.9 KB
references/shadows.mdmarkdown1.3 KB
references/slider.mdmarkdown3.6 KB
references/stepper.mdmarkdown4.7 KB
references/table.mdmarkdown8.4 KB
references/tabs.mdmarkdown3.8 KB
references/tag.mdmarkdown5.0 KB
references/thumbnail.mdmarkdown1.9 KB
references/timepicker.mdmarkdown5.1 KB
references/toast.mdmarkdown3.4 KB
references/toggle.mdmarkdown2.1 KB
references/tooltip.mdmarkdown4.1 KB
references/typography.mdmarkdown3.3 KB
references/utility-classes.mdmarkdown3.9 KB
references/web-components.mdmarkdown2.1 KB

references/color-tokens.md

View on GitHub
- [Color tokens (`--e-color-*`)](#color-tokens---e-color-)
  - [Reference](#reference)
  - [Installation](#installation)
  - [Use](#use)
  - [Tokens](#tokens)
    - [Purpose tokens](#purpose-tokens)
    - [Contrast tokens](#contrast-tokens)
    - [Theme behavior](#theme-behavior)
    - [Base tokens](#base-tokens)
  - [Guidelines](#guidelines)
    - [When to use](#when-to-use)
    - [When not to use](#when-not-to-use)
  - [Accessibility](#accessibility)
  - [Examples](#examples)

# Color tokens (`--e-color-*`)

## Reference

https://design.elvia.io/brand/color

Color tokens are CSS custom properties for custom UI, not a web component or a CSS class component.

## Installation

Color tokens require the `@elvia/elvis` CSS package. See [Installation](./installation.md).

## Use

Use `var(--e-color-*)` for colors in custom UI outside the design system. Select a purpose token by its role,
not its current color. Prefer these tokens over custom hex, RGB, HSL, or named color values. Avoid colors
outside the Elvia palette.

```html
<section class="custom-panel">Forbruk denne måneden</section>
```

```css
.custom-panel {
  background-color: var(--e-color-background-element-4);
  color: var(--e-color-background-element-4--contrast);
  border: 1px solid var(--e-color-border-2);
}
```

## Tokens

### Purpose tokens

Use these tokens as a starting point. See the [token catalog](https://design.elvia.io/brand/color#Tokens) for
other roles.

- Main background: `--e-color-background-1`, `--e-color-background-2`.
- Large dark surface: `--e-color-background-3`.
- Element surface, such as a box or modal: `--e-color-background-element-4`.
- Primary text: `--e-color-text-1`.
- Muted text: `--e-color-text-2`.
- Placeholder text: `--e-color-text-placeholder-1`.
- Primary disabled text: `--e-color-text-disabled-1`.
- High-contrast border: `--e-color-border-1`.
- Low-contrast border: `--e-color-border-2`.
- Medium-contrast border: `--e-color-border-3`.
- Hover background: `--e-color-background-hover-1`, `--e-color-background-hover-2`.
- Selected background: `--e-color-background-selected-1`, `--e-color-background-selected-2`.
- Disabled background: `--e-color-background-disabled-1`.
- Read-only background: `--e-color-background-readonly-1`.
- Hover border: `--e-color-border-hover-1`.
- Selected border: `--e-color-border-selected-1`, `--e-color-border-selected-2`.
- Disabled border: `--e-color-border-disabled-1`.
- Success: `--e-color-signal-positive`.
- Caution: `--e-color-signal-caution`.
- Warning: `--e-color-signal-warning`.
- Error or danger: `--e-color-signal-danger`.
- Neutral information: `--e-color-signal-info`.
- Data series: `--e-color-data-1`, `--e-color-data-2`, `--e-color-data-3`, `--e-color-data-4`,
  `--e-color-data-5`, `--e-color-data-6`.
- Brand accent: `--e-color-brand-accent`.

Use shade tokens, such as `--e-color-data-1-50`, instead of custom tints or opacity changes.

### Contrast tokens

Use the associated `--contrast` token for text on a colored surface. Change the text token with the background
token for each state.

```css
.custom-item--selected {
  background-color: var(--e-color-background-selected-2);
  color: var(--e-color-background-selected-2--contrast);
}
```

### Theme behavior

Purpose tokens use the light theme by default. The `e-theme-light` and `e-theme-dark` CSS classes set the
theme for an element and its descendants. Keep the same purpose token names in both themes.

```html
<div class="e-theme-dark">
  <section class="custom-panel">Forbruk denne måneden</section>
</div>
```

Setting `background-color: var(--e-color-background-3)` alone does not change descendant tokens. The
`e-color-background-3` CSS class also sets dark-theme tokens for descendants.

### Base tokens

Use base tokens only when no purpose token fits. Keep this exception within the Elvia palette. Base tokens use
`--e-light-theme-*` and `--e-dark-theme-*`, not `--e-color-*`. For example, `--e-light-theme-grey-10` and
`--e-dark-theme-grey-20` are base tokens. Select the corresponding base token explicitly for each theme.

## Guidelines

### When to use

- Use purpose tokens for custom surfaces, text, borders, states, and data displays.
- Use neutral surfaces for most of the interface.
- Reserve green accents for deliberate emphasis or active states.

### When not to use

- Prefer an existing Elvis component when it meets the need.
- Avoid large green backgrounds.
- Avoid base tokens when a purpose token fits.
- Avoid static palette values as fallbacks for purpose tokens.
- You do not need to provide a fallback color for the tokens, trust that the Elvis CSS loads as expected.

## Accessibility

- Use the matching contrast token instead of an assumed black or white text color.
- `--e-color-background-element-1` becomes transparent in the dark theme.
- Check text contrast against the actual parent surface when this token is transparent.

## Examples

**Input:** Add a custom summary panel with a heading and secondary text.

**Output:**

```html
<section class="custom-summary">
  <h2>Forbruk</h2>
  <p class="custom-summary__note">Oppdatert i dag</p>
</section>
```

```css
.custom-summary {
  background-color: var(--e-color-background-1);
  color: var(--e-color-background-1--contrast);
  border: 1px solid var(--e-color-border-3);
}

.custom-summary__note {
  color: var(--e-color-text-2);
}
```

**Input:** Show a success message with a neutral background and a green border accent.

**Output:**

```html
<p class="custom-status" role="status">Endringene er lagret.</p>
```

```css
.custom-status {
  background-color: var(--e-color-background-1);
  color: var(--e-color-background-1--contrast);
  border: 1px solid var(--e-color-signal-positive);
}
```
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall