Badge

A status badge with color × variant × size props for marking state on a row, card, or record — auto-derives a legible foreground from any token.

Colors (solid)

primarysecondaryaccentneutralinfosuccesswarningerrorbrandsilicabrand-duck

Variant · outline

primarysecondaryaccentneutralinfosuccesswarningerrorbrandsilicabrand-duck

Variant · soft

primarysecondaryaccentneutralinfosuccesswarningerrorbrandsilicabrand-duck

Variant · ghost

primarysecondaryaccentneutralinfosuccesswarningerrorbrandsilicabrand-duck

Variant · dash

primarysecondaryaccentneutralinfosuccesswarningerrorbrandsilicabrand-duck

Sizes

primaryprimaryprimaryprimaryprimary

Using Badge

Silica ships one design system through three paths. They share a class vocabulary but are not interchangeable — pick the one that matches what you are building.

Plain HTML — CSS classes

The Tailwind v4 plugin. Works in any framework or none — Rails, Django, PHP, Go, a static file. This path is complete for Badge — it needs no JavaScript, so the classes below are the whole story.

/* in your CSS */
@import "tailwindcss";
@plugin "@wizeworks/silicaui";

Root class badge, with 17 modifiers:

.badge
.badge-accent
.badge-dash
.badge-error
.badge-ghost
.badge-info
.badge-lg
.badge-md
.badge-neutral
.badge-outline
.badge-primary
.badge-secondary
.badge-sm
.badge-soft
.badge-success
.badge-warning
.badge-xl
.badge-xs

React

Typed components over those same classes, with behavior and accessibility from Base UI.

npm i @wizeworks/silicaui-react

import { Badge } from "@wizeworks/silicaui-react";

Props

Prop	Type	Required	Description
color	BadgeColor	no	Semantic or custom color; maps to badge-<color>.
variant	BadgeVariant	no	How the color is applied. Default solid.
size	BadgeSize	no	Default md.
render	React.ReactElement	no	Render as a different element while keeping Silica's classes. CLIENT COMPONENTS ONLY — from a React Server Component the element loses its props crossing the "use client" boundary.

Source of the demo above

The exact file that renders the examples above, so it can never drift from them. It imports a few of this site’s own layout helpers (../lib/…), so read it for the component calls rather than copying it whole.

Show source

import { Badge } from "@wizeworks/silicaui-react";
import { ColorVariantSizeGrid } from "../lib/ColorGrid";

export function BadgeDemo() {
    return (
        <ColorVariantSizeGrid
            Component={Badge}
            variants={["outline", "soft", "ghost", "dash"]}
        />
    );
}

Vanilla — node tree to HTML

Badge — lowers to <span>, carrying props.text as its content. Build a node tree, project it with toHtml(), and let the zero-dependency runtime hydrate it. This is the path for generated or user-authored documents — a site builder, CMS output, a static export.

npm i @wizeworks/silicaui-html @wizeworks/silicaui-behaviors

import { atom, toHtml } from "@wizeworks/silicaui-html";

const node = atom("Badge", "badge", { /* props */ });
const markup = toHtml(node);

Styling on this path is the class string in the second argument — the same classes as the Plain HTML section above. There is no color prop here; write "badge badge-primary" rather than passing a colour as a prop.

Takes children: no
Hydrated by: nothing — this one is static markup

The full API for Badge, on every path, is available through the Silica MCP server.