NV Elements Catalog Starters Repo System Themes Getting Started Getting Started Installation CLI MCP Skills Lint Integrations Getting Started Angular Bundles Custom Elements Golang Hugo Import Maps Lit Lit Library MCP Apps NextJS Nuxt Preact React SolidJS Svelte TypeScript Vue About Changelog Metrics Support Accessibility Contributions Requests Migration Foundations Overview Typography Iconography Themes Design Tokens Size & Space Objects Interactions Support Status Color Animation Fonts Layers Custom Layout Horizontal Vertical Grid Popovers i18n Visualization View Transitions Elements Accordion Alert Avatar Badge Breadcrumb Button Button Group Card Chat Message Checkbox Color Combobox Copy Button Datagrid Integrations Column Action Column Alignment Column Fixed Column width Container Card Display Settings Footer Heatmap Keynav Multi Select Pagination Panel Detail Panel Grid Performance Placeholder Row Action Row Groups Row Sort Scroll Height Single Select Stripe Date Datetime Dialog Divider Dot Drawer Dropdown Dropdown Group Dropzone File Format Datetime Format Number Format Relative Time Forms Validation Actions Control Icon Icon Button Input Input Group Logo Menu Month Notification Page Page Header Page Loader Pagination Progressive Filter Chip Progress Bar Progress Ring Password Preferences Input Pulse Radio Range Resize Handle Search Select Skeleton Sort Button Sparkline Star Rating Steps Switch Tabs Tag Textarea Time Toast Toggletip Toolbar Tooltip Tree Week Patterns Authentication Browse Chat Dashboard Editor Empty States Heatmap Keyboard Shortcut Logging Media Navigation Onboarding Panel Responsive Search Subheader Trend Code Codeblock Monaco Input Diff Input Editor Diff Editor Problems Markdown Markdown CSS Utility Labs Responsive Layout Viewport Container Patterns Forms API Design Properties & Attributes Slots Registration CustomEvents Stateless Composition Styles Packaging Glossary Logs Internal Guidelines Agent Harness Agent Tooling Agent Ownership Documentation Examples TypeScript Testing Unit Testing Accessibility Testing Lighthouse Testing SSR Testing Visual Testing Troubleshooting Component Creation Internal Examples All Examples

Badge

stable:  0.2.3 Coverage: 92.85% Bundle: 16.2kb Lighthouse: 100 Axe Core Released: 0.11.0
Overview API Examples
DefaultStatusStatusFlatStatusIconSupportStatusLightThemeStatusDarkThemeTrendColorProminenceFlatOverflow

Default

badge
Edit Example

A visual indicator that communicates a status description of an associated component. Status badges use short text, color, built in icons for quick recognition and render near the relevant content.

Status

test-case
scheduled queued pending starting running restarting stopping finished failed unknown ignored
Edit Example

Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions.

Status Description accent Highlights important actions or draws attention to primary interactive elements. warning Indicates cautionary actions that require careful consideration before proceeding. success Represents positive outcomes, confirmations, or constructive actions. danger Signals destructive or irreversible actions that need extra attention and confirmation. scheduled Task has a scheduled future execution at a specific time. queued Task is waiting in line to begin after other tasks complete. pending Task is awaiting approval, user input, or external conditions before proceeding. starting Task is initializing and preparing to begin active execution. running Task is actively executing and making progress. restarting Task restarts after an interruption or reset. stopping Task is gracefully shutting down and completing cleanup operations. finished Task has completed successfully with the expected outcome. failed Task encountered an error and did not complete as intended. unknown Task status remains unknown or unavailable. ignored Task was intentionally skipped or excluded from execution.

Status Flat

test-case
scheduled queued pending starting running restarting stopping finished failed unknown ignored
Edit Example

Flat container badges with status colors for a more subtle appearance. Perfect for dense layouts or when you want less visual weight.

Status Icon

Edit Example

Status badges with icons only, using aria-label for accessibility. Useful for compact status indicators in toolbars or data tables.

Support

accent warning success danger
Edit Example

Support status badges for general feedback states. Use for success, warning, error, or informational messages.

Status Light Theme

test-case
scheduled queued pending starting running restarting stopping finished failed unknown ignored
Edit Example

Status badges in light theme for better visibility on light backgrounds. Use when your application primarily uses light mode.

Status Dark Theme

test-case
scheduled queued pending starting running restarting stopping finished failed unknown ignored
Edit Example

Status badges in dark theme for better visibility on dark backgrounds. Use when your application primarily uses dark mode.

Trend

patterntest-case
0% -15% +15%
Edit Example

Trend badges for displaying data changes and metrics. Perfect for dashboards, analytics, or financial data showing positive, negative, or neutral trends.

Color

test-case
red-cardinal gray-slate gray-denim blue-indigo blue-cobalt blue-sky teal-cyan green-mint teal-seafoam green-grass yellow-amber orange-pumpkin red-tomato pink-magenta purple-plum purple-violet purple-lavender pink-rose green-jade lime-pear yellow-nova brand-green
Edit Example

Defines a base color from the theme color palette

Color Description red-cardinal gray-slate gray-denim blue-indigo blue-cobalt blue-sky teal-cyan green-mint teal-seafoam green-grass yellow-amber orange-pumpkin red-tomato pink-magenta purple-plum purple-violet purple-lavender pink-rose green-jade lime-pear yellow-nova brand-green

Prominence

red-cardinal gray-slate gray-denim blue-indigo blue-cobalt blue-sky teal-cyan green-mint teal-seafoam green-grass yellow-amber orange-pumpkin red-tomato pink-magenta purple-plum purple-violet purple-lavender pink-rose green-jade lime-pear yellow-nova brand-green
Edit Example

Controls the visual prominence to establish hierarchy and guide user attention.

Prominence Description emphasis Increases visual weight to draw attention and highlight important elements.

Flat

red-cardinal gray-slate gray-denim blue-indigo blue-cobalt blue-sky teal-cyan green-mint teal-seafoam green-grass yellow-amber orange-pumpkin red-tomato pink-magenta purple-plum purple-violet purple-lavender pink-rose green-jade lime-pear yellow-nova brand-green
Edit Example

Flat container badges with custom colors for a minimal, borderless appearance. Ideal for subtle categorization or when you want to reduce visual noise.

Overflow

test-case
some really long content
Edit Example

Badge with constrained width to show text overflow behavior. Use when you need to control badge width in constrained layouts or responsive designs.