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/tag.md

View on GitHub
- [Tag (`e-tag`)](#tag-e-tag)
  - [Reference](#reference)
  - [Installation](#installation)
  - [Use](#use)
  - [Colors](#colors)
  - [Guidelines](#guidelines)
    - [When to use](#when-to-use)
    - [Text and color](#text-and-color)
  - [Accessibility](#accessibility)
  - [Classes](#classes)
  - [Examples](#examples)

# Tag (`e-tag`)

## Reference

https://design.elvia.io/components/tag

Tag is a CSS-based component, consisting of CSS classes only.

## Installation

This CSS-based component requires the `@elvia/elvis` package. If it is not already installed, follow the
[Elvis installation reference](./installation.md) before using the tag classes.

## Use

```html
<span class="e-tag">Faktura</span>
```

## Colors

`e-tag` has no colored dot. Add one color modifier to show a dot before the text:

```html
<span class="e-tag e-tag--positive">Aktiv</span>
```

Available color modifiers:

- **Signal colors:** `e-tag--positive`, `e-tag--danger`, `e-tag--warning`, `e-tag--neutral`
- **Data colors:** `e-tag--data-1`, `e-tag--data-2`, `e-tag--data-3`, `e-tag--data-4`, `e-tag--data-5`,
  `e-tag--data-6`

Prefer the most semantic alias when possible, eg. `e-tag--positive` instead of `e-tag--green`. Use only one
color modifier at a time. For an inverted background, add `e-tag--inverted` as a separate theme modifier:

```html
<span class="e-tag e-tag--inverted e-tag--neutral">Arkivert</span>
```

Semantic status modifiers and their color aliases:

| Modifier(s)                                   | Underlying color token                   | Intended meaning                                                 |
| --------------------------------------------- | ---------------------------------------- | ---------------------------------------------------------------- |
| `e-tag--positive`, `e-tag--success`           | `--e-color-signal-positive`              | Successful or completed status                                   |
| `e-tag--caution`, `e-tag--yellow`             | `--e-color-signal-caution`               | A status that needs attention                                    |
| `e-tag--warning`, `e-tag--orange`             | `--e-color-signal-warning`               | A warning status                                                 |
| `e-tag--error`, `e-tag--danger`, `e-tag--red` | `--e-color-signal-danger`                | An error or negative status                                      |
| `e-tag--neutral`                              | `--e-tag-color-neutral` (theme-adaptive) | Neither positive nor negative, such as in progress or registered |

The numbered data modifiers (`e-tag--data-1` through `e-tag--data-6`) are palette identifiers for
categorization only, never for status. Their numbers identify colors; they do not imply meaning, priority, or
order. Use them to distinguish categories, not to communicate a status.

## Guidelines

### When to use

- Use tags to categorize items or show their status.
- Pair a tag with the item it describes; do not use tags alone.
- For an interactive action, use a link or button instead of styling it as a tag.
- Prefer `e-tag` over custom tags or classes.
- Use `e-tag--neutral` for neutral statuses, such as in progress or registered.
- Use `e-tag--data-1` through `e-tag--data-6` for categorization only, never for status.

### Text and color

- Keep the label short and descriptive, with a maximum of two words.
- For status labels, use `positive`/`success` for successful states, `caution` or `warning` when attention is
  needed, `danger`/`error` for errors or negative states, and `neutral` when the state is neither good nor
  bad.
- Use data colors for categorization only; do not use them to communicate status.
- Do not use tags for standalone numeric values such as IDs or amounts.

## Accessibility

- Use a static element, such as `<span>` or `<div>`.
- Keep the text meaningful without its color. Do not rely on color alone to communicate.
- If the item needs an action, use a native link or button with its normal accessible name and interaction
  behavior. Tags are not interactive elements themselves.

## Classes

Classes use BEM.

Base: `e-tag`

**Modifiers**

- `e-tag--black`
- `e-tag--blue-berry`
- `e-tag--caution`
- `e-tag--danger`
- `e-tag--data-1`
- `e-tag--data-2`
- `e-tag--data-3`
- `e-tag--data-4`
- `e-tag--data-5`
- `e-tag--data-6`
- `e-tag--error`
- `e-tag--green-apple`
- `e-tag--green`
- `e-tag--grey`
- `e-tag--inverted`
- `e-tag--neutral`
- `e-tag--orange-mango`
- `e-tag--orange`
- `e-tag--positive`
- `e-tag--purple-plum`
- `e-tag--red-tomato`
- `e-tag--red`
- `e-tag--success`
- `e-tag--violet-grape`
- `e-tag--warning`
- `e-tag--white`
- `e-tag--yellow`

## Examples

**Input:** Add a status label to a task.

**Output:**

```html
<div>
  <span>Oppgavestatus</span>
  <span class="e-tag e-tag--positive">Fullført</span>
</div>
```

**Input:** Categorize this item.

**Output:**

```html
<div>
  <span>Forbruk</span>
  <span class="e-tag e-tag--data-1">Bolig</span>
  <span class="e-tag e-tag--data-2">Fritid</span>
  <span class="e-tag e-tag--data-3">Næring</span>
</div>
```
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