Badge
Free · MITHeadless, accessible, and styled entirely through the attribute surface below — bring your own CSS system, or start from the reference theme.
Install
Without a flag you get no styling at all — plain HTML carrying the attribute surface below. --theme copies the same theme in two dialects;--bridge lumos re-points either one onto Lumos for Astro's tokens (it needs a theme to re-point, and Lumos itself, already in your project).
Unstyled — behavior only, you write the CSS
npx astrocraft-ui add display/badgePlain-CSS theme — no build step
npx astrocraft-ui add display/badge --theme cssTailwind theme — needs Tailwind v4
npx astrocraft-ui add display/badge --theme tailwindPlain-CSS theme, re-pointed onto Lumos tokens
npx astrocraft-ui add display/badge --theme css --bridge lumosTailwind theme, re-pointed onto Lumos tokens
npx astrocraft-ui add display/badge --theme tailwind --bridge lumosLive demo
Badge
Attribute surface
With no class-merging machinery, these attributes are the whole extension point. State is a data-attribute or a native attribute; visibility is the hiddenattribute. Generated from source by pnpm slots.
| Component | Slots | Variants | Runtime state | Native state |
|---|---|---|---|---|
| `Badge.astro` | `badge` | `data-variant`: `primary` · `secondary` · `muted` · `outline` · `info` · `success` · `warning` · `error` | — | — |
Source
What the command copies — 2 files, alias-free so the copy lands standing alone. This is the whole component; there is nothing else.
---
// src/components/ui/display/badge/Badge.astro — headless primitive (see ../../README.md).
// Static status pill; semantic tone via `variant`, exposed as `data-variant`.
import type { HTMLAttributes } from "astro/types";
type Props = HTMLAttributes<"span"> & {
variant?:
"primary" | "secondary" | "muted" | "outline" | "info" | "success" | "warning" | "error";
};
const { variant = "primary", class: className, ...rest } = Astro.props;
---
<span class={className} data-slot="badge" data-variant={variant} {...rest}><slot /></span>
import Badge from "./Badge.astro";
export { Badge };
export default Badge;
What you get
The component source, copied into your project by npx astrocraft-ui add display/badge — no package dependency, no CSS to fight. Whatever the paid blocks compose, this is it.