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

View on GitHub
- [Alert (`e-alert`)](#alert-e-alert)
  - [Reference](#reference)
  - [Installation](#installation)
  - [Use](#use)
    - [Local and global alerts](#local-and-global-alerts)
    - [Status and icons](#status-and-icons)
    - [Actions and close buttons](#actions-and-close-buttons)
  - [Classes](#classes)
  - [Guidelines](#guidelines)
    - [When to use](#when-to-use)
    - [When not to use](#when-not-to-use)
  - [Accessibility](#accessibility)
  - [Examples](#examples)

# Alert (`e-alert`)

## Reference

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

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

## Installation

This component requires the `@elvia/elvis` package. See the [installation reference](./installation.md).

## Use

```html
<div class="e-alert e-alert--info" role="note">
  <span class="e-alert__icon">
    <e-icon name="informationCircle" class="e-icon--color-grey"></e-icon>
  </span>
  <p class="e-alert__text">Du kan endre kontaktinformasjonen din på Min side.</p>
</div>
```

See the [Icon reference](./icon.md).

### Local and global alerts

- **Local:** `e-alert` is the default. Place it near the related content, between the header and footer.
- **Global:** Add `e-alert--global`. Place it at the bottom of the viewport, with full width.

### Status and icons

- `e-alert--error`: Use for a failure or a problem that prevents task completion. Use the `removeCircle` icon
  with `e-icon--color-danger`.
- `e-alert--warn`: Use for a warning that helps the user prevent an error. Use the `warningCircle` icon with
  `e-icon--color-warning`.
- `e-alert--info`: Use for context, tips, or suggestions. Use the `informationCircle` icon with
  `e-icon--color-grey`.

Without a status modifier, local alerts use the error color, and global alerts use the information color.

### Actions and close buttons

- Place local `e-alert__actions` inside `e-alert__text`.
- Place global `e-alert__actions` directly inside `e-alert`.
- Place an optional `e-alert__title` directly inside `e-alert`. The layout adapts automatically when the title
  is absent.
- Place an optional close button inside `e-alert__close`. Use the `closeBold` icon and the small icon-button
  classes from the [Button reference](./button.md). Add a click handler to remove the alert.

## Classes

Classes use BEM.

Base: `e-alert`

**Elements**

- `e-alert__actions`
- `e-alert__close`
- `e-alert__icon`
- `e-alert__text`
- `e-alert__title`

**Modifiers**

- `e-alert--error`
- `e-alert--global`
- `e-alert--info`
- `e-alert--warn`

## Guidelines

### When to use

- Use a local alert for a medium-urgency problem related to page content or a user action. Place it near the
  affected content.
- Use a global alert for a high-urgency system or product message that applies across the application.
- Use an alert when a failure prevents task completion or the user must correct a problem.

### When not to use

- Use a [Toast](./toast.md) for a completed action confirmation or a minor contextual update, tip, or
  suggestion.

## Accessibility

The alert CSS classes do not set an accessibility role. Choose the role from the message urgency, not the
status modifier or the local/global type.

## Examples

**Input:** Show a local warning with an action near the affected content.

**Output:**

```html
<div class="e-alert e-alert--warn" role="note">
  <span class="e-alert__icon">
    <e-icon name="warningCircle" class="e-icon--color-warning"></e-icon>
  </span>
  <h2 class="e-alert__title">Kontaktinformasjon mangler</h2>
  <div class="e-alert__text">
    Legg til kontaktinformasjon for å motta varsler.
    <div class="e-alert__actions">
      <a class="e-link" href="/kontaktinformasjon">Oppdater kontaktinformasjon</a>
    </div>
  </div>
</div>
```

**Input:** Show a global maintenance message across all application pages.

**Output:**

```html
<div class="e-alert e-alert--global e-alert--info" role="note" id="maintenance-alert">
  <span class="e-alert__icon">
    <e-icon name="informationCircle" class="e-icon--color-grey"></e-icon>
  </span>
  <h2 class="e-alert__title">Planlagt vedlikehold</h2>
  <p class="e-alert__text">Min side er utilgjengelig lørdag fra kl. 08 til 10.</p>
  <div class="e-alert__actions">
    <a class="e-link" href="/driftsmeldinger">Se driftsmeldinger</a>
  </div>
</div>
```

```css
#maintenance-alert {
  position: fixed;
  inset: auto 0 0;
}
```
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