Start typing to search components and docs…
select navigate ESC close

Badges

Flexible badge component for displaying product labels, tags, and status indicators. Supports both simple string arrays and complex badge objects with custom colors and metadata.

Live Demo

Badges - GTI

GTI
Motorsport
Lorem Ipsum
<script setup>
import Badges from 'spoko-design-system/src/components/Badges.vue';
</script>
<div class="relative min-h-19">
  <Badges :badges="['GTI', 'Motorsport', 'Lorem Ipsum']" class="top-2" />
</div>

Badge on image

image alt
Motorsport
<div class="relative">
<img src="https://placehold.co/300x200" alt="image alt" />
<Badges :badges="['Motorsport']" class="top-2" />
</div>

Few badges on image

image alt
Motorsport
Lorem ipsum
GTI
<div class="relative">
<img src="https://placehold.co/300x200" alt="image alt" />
<Badges :badges="['Motorsport', 'Lorem ipsum', 'GTI']" class="top-2" />
</div>

Generic Badge Classes

Semantic status badges using SDS shortcut classes — no JavaScript required.

PrimarySecondarySuccessErrorWarningInfoNeutral
<span class="badge-primary">Primary</span>
<span class="badge-secondary">Secondary</span>
<span class="badge-success">Success</span>
<span class="badge-error">Error</span>
<span class="badge-warning">Warning</span>
<span class="badge-info">Info</span>
<span class="badge-neutral">Neutral</span>

Props

PropTypeDefaultDescription
badges(string | BadgeObject)[][]Array of badge labels (strings) or badge objects with slug, label, type, color, and priority properties.

Badge Object Structure

When using badge objects instead of simple strings:

interface BadgeObject {
  slug: string;           // Unique identifier
  label: string;          // Display text
  type?: string;          // Type indicator (optional)
  color?: string;         // CSS class for color (e.g., "bg-red-600")
  priority?: number;      // Sort priority (optional)
}

CSS Shortcuts

Status badges using semantic CSS classes — no JavaScript required:

Class Purpose
badge-primary Primary/default badge style
badge-secondary Secondary badge style
badge-success Success/positive indicator
badge-error Error/danger indicator
badge-warning Warning/attention indicator
badge-info Information badge
badge-neutral Neutral/default badge