Sstepkit
foundations · Original · MIT

Badge

A compact status signal with semantic tones and an optional dot.

Live preview

Adjust a setting to update the preview and usage code together.

Usage & source

import type { CSSProperties } from "react";
import { Badge } from "./components/stepkit/Badge";
import "./components/stepkit/styles.css";

const themeStyle = {"--stepkit-bg":"#f7f7f8","--stepkit-surface":"#ffffff","--stepkit-surface-muted":"#f0f0f3","--stepkit-fg":"#17181c","--stepkit-muted":"#626572","--stepkit-border":"#e3e4e9","--stepkit-border-strong":"#c8cad3","--stepkit-code":"#f1f1f4","--stepkit-shadow":"0 20px 60px rgba(31, 26, 64, .10)","--stepkit-accent":"#6950df","--stepkit-accent-strong":"#5137c7","--stepkit-accent-soft":"#eeeafd","--stepkit-accent-on-soft":"#5137c7","--stepkit-accent-text":"#ffffff","--stepkit-error":"#b43145","--stepkit-placeholder":"#626572","--stepkit-radius":"16px","--stepkit-space":"16px","--stepkit-control-height":"44px","--stepkit-font-sans":"Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif"} as CSSProperties;

export default function Example() {
  return (
    <div className="stepkit-theme" data-stepkit-preset="modern" style={themeStyle}>
      <Badge
      children={"In review"}
      tone={"accent"}
      dot={true}
      />
    </div>
  );
}

Dependencies

[email protected]
[email protected]

Install

Use the released registry entry or download the complete archive.

npx [email protected] add https://vstepanov.com/stepkit/r/badge.json

Integration prompt

Install Stepkit Badge 0.2.0 from the registry and preserve the included MIT notice.
npx [email protected] add https://vstepanov.com/stepkit/v0.2.0/r/badge.json
Install the tested runtime dependencies exactly: npm install [email protected] [email protected]
Keep the component source, shared styles, NOTICE.md, and provenance files together. Apply the theme tokens on a wrapper rather than passing theme keys as component props.

Usage:
```tsx
import type { CSSProperties } from "react";
import { Badge } from "./components/stepkit/Badge";
import "./components/stepkit/styles.css";

const themeStyle = {"--stepkit-bg":"#f7f7f8","--stepkit-surface":"#ffffff","--stepkit-surface-muted":"#f0f0f3","--stepkit-fg":"#17181c","--stepkit-muted":"#626572","--stepkit-border":"#e3e4e9","--stepkit-border-strong":"#c8cad3","--stepkit-code":"#f1f1f4","--stepkit-shadow":"0 20px 60px rgba(31, 26, 64, .10)","--stepkit-accent":"#6950df","--stepkit-accent-strong":"#5137c7","--stepkit-accent-soft":"#eeeafd","--stepkit-accent-on-soft":"#5137c7","--stepkit-accent-text":"#ffffff","--stepkit-error":"#b43145","--stepkit-placeholder":"#626572","--stepkit-radius":"16px","--stepkit-space":"16px","--stepkit-control-height":"44px","--stepkit-font-sans":"Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, \"Segoe UI\", sans-serif"} as CSSProperties;

export default function Example() {
  return (
    <div className="stepkit-theme" data-stepkit-preset="modern" style={themeStyle}>
      <Badge
      children={"In review"}
      tone={"accent"}
      dot={true}
      />
    </div>
  );
}
```

Selected bounded settings: {"children":"In review","tone":"accent","dot":true}.
Selected theme: {"mode":"light","accent":"violet","radius":"soft","density":"comfortable","preset":"modern"}.

Props

NameTypeDefaultDescription
tone"neutral" | "accent" | "success" | "warning" | "danger" | "info""neutral"Chooses the semantic colour.
dotbooleanfalseAdds a compact status dot.
childrenReactNode"In review"Label content.

Accessibility & limits

  • The badge is a span so it does not create an unexpected control.
  • Colour is paired with text, not used as the only status signal.

Limitations

  • It does not announce live status changes by itself.

Provenance

Original source under the MIT licence.

Original Stepkit implementation.

Required notices: NOTICE.md, PROVENANCE-stepkit-badge.md

  • 2 source files in the release
  • Version 0.2.0