Badge labels
Five labels that carry a marker after the text: a counter, a status dot, a New badge, a Beta badge and an outlined tag chip. The markers read as text, colors resolve to ai2 tokens only, and every label is a real label element bound to its input with htmlFor.
Installation
The styled layer is free and installs like any other ai2 component.
Run the following command
npx shadcn@latest add @ai2/label-badgeDependencies, the @ai2/tokens theme and the component file are installed together.
Install dependencies
npm install lucide-reactCopy the source
components/ui/label-badge.tsx"use client"
import * as React from "react"
import { Tag } from "lucide-react"
import { cn } from "@/lib/utils"
/* Badge label family: 5 labels, each carrying a marker AFTER the text (a counter, a
status dot, a new/beta badge, a tag chip). The markers are not aria-hidden;
because they carry readable text they reach the screen reader too, and only the
status dot is decorative. The label is a REAL <label> bound with htmlFor to the
rendered demo input (the id comes from React.useId()).
The badge backgrounds use color-mix for alpha. Color comes ONLY from tokens.
Static - no animation, motion is not needed. */
export type StyledSize = "sm" | "md" | "lg" | "xl"
const text: Record<StyledSize, string> = {
sm: "text-xs",
md: "text-sm",
lg: "text-sm",
xl: "text-base",
}
/* Demo input yuksekligi base Button olcegine hizali. */
const inputHeight: Record<StyledSize, string> = {
sm: "h-8",
md: "h-9",
lg: "h-10",
xl: "h-12",
}
const base =
"inline-flex w-fit items-center gap-1.5 font-medium leading-none text-foreground select-none [&_svg]:size-4 [&_svg]:shrink-0 [&_i]:text-base [&_i]:leading-none"
const field = "flex w-fit flex-col gap-1.5"
const inputBase =
"w-48 rounded-md border border-field-border bg-transparent px-3 text-sm text-foreground outline-none transition-colors placeholder:text-muted-foreground focus-visible:ring-[3px] focus-visible:ring-ring/50"
/* Rozet cipi: kucuk, yuvarlak, ton zeminli. */
const chip =
"inline-flex items-center gap-1 rounded-full px-1.5 py-0.5 text-[10px] font-semibold leading-none [&>svg]:size-3 [&>svg]:shrink-0 [&>i]:text-xs [&>i]:leading-none"
type Props = Omit<React.ComponentProps<"label">, "htmlFor"> & { size?: StyledSize }
/* Shared shell: the label plus the marker that follows it, then the bound demo input. */
function BadgeField({
tone,
marker,
className,
size = "md",
children,
...props
}: Props & { tone: string; marker: React.ReactNode }) {
const id = React.useId()
return (
<span data-slot="styled-label" data-tone={tone} className={field}>
<label htmlFor={id} className={cn(base, text[size], className)} {...props}>
{children ?? "Email"}
{marker}
</label>
<input
id={id}
type="text"
placeholder="you@example.com"
className={cn(inputBase, inputHeight[size])}
/>
</span>
)
}
/* Count: metnin ardinda sayac cipi. count prop, varsayilan 3 (deterministik). */
export function CountLabel({ count = 3, ...props }: Props & { count?: number }) {
return (
<BadgeField
tone="neutral"
marker={
<span
className={cn(
chip,
"tabular-nums text-muted-foreground [background-color:color-mix(in_oklab,var(--color-foreground)_10%,transparent)]"
)}
>
{count}
</span>
}
{...props}
/>
)
}
/* Status: success tonlu nokta + durum metni. */
export function StatusLabel({ status = "Live", ...props }: Props & { status?: string }) {
return (
<BadgeField
tone="success"
marker={
<span
className={cn(
chip,
"text-success-soft-foreground [background-color:color-mix(in_oklab,var(--color-success)_16%,transparent)]"
)}
>
<span aria-hidden="true" className="size-1.5 shrink-0 rounded-full bg-success" />
{status}
</span>
}
{...props}
/>
)
}
/* New: info tonlu NEW rozeti. */
export function NewLabel(props: Props) {
return (
<BadgeField
tone="info"
marker={
<span
className={cn(
chip,
"uppercase tracking-wide text-info-soft-foreground [background-color:color-mix(in_oklab,var(--color-info)_16%,transparent)]"
)}
>
New
</span>
}
{...props}
/>
)
}
/* Beta: warning tonlu BETA rozeti. */
export function BetaLabel(props: Props) {
return (
<BadgeField
tone="warning"
marker={
<span
className={cn(
chip,
"uppercase tracking-wide text-warning-soft-foreground [background-color:color-mix(in_oklab,var(--color-warning)_18%,transparent)]"
)}
>
Beta
</span>
}
{...props}
/>
)
}
/* Tag: ikonlu, cerceveli etiket cipi. */
export function TagLabel({ tag = "internal", ...props }: Props & { tag?: string }) {
return (
<BadgeField
tone="brand"
marker={
<span className={cn(chip, "border border-border text-muted-foreground")}>
<Tag />
{tag}
</span>
}
{...props}
/>
)
}Manual installs skip the @ai2/tokens theme, so add the token CSS from the theming guide or the tone colors will be missing.
Variations
5 takes on the same idea. Each is its own export, and every one accepts a size prop (sm, md, lg, xl) aligned to the base Button scale.
Count
A neutral counter chip after the text.
import { CountLabel } from "@/components/ui/label-badge"
<CountLabel>Email</CountLabel>Status
A success dot with a short status word.
import { StatusLabel } from "@/components/ui/label-badge"
<StatusLabel>Email</StatusLabel>New
An info-toned New badge for a fresh field.
import { NewLabel } from "@/components/ui/label-badge"
<NewLabel>Email</NewLabel>Beta
A warning-toned Beta badge for an unfinished field.
import { BetaLabel } from "@/components/ui/label-badge"
<BetaLabel>Email</BetaLabel>Tag
An outlined chip with a leading icon and a tag name.
import { TagLabel } from "@/components/ui/label-badge"
<TagLabel>Email</TagLabel>ai2 Badge labels: 5 styled variations on the token system
The ai2 Badge labels are a set of 5 decorative button variations from the styled layer of the @ai2 design system, built around a form label with a trailing marker. They are free and MIT licensed, and every color comes from a semantic token, so they theme with the rest of ai2 in light and dark.
Motion runs on framer-motion: these labels are static, so no motion library work is required. The styled layer is opt-in, so the dependency only lands if you use it; the base components stay lean. Under reduced motion, there is no motion to reduce.
What is in the ai2 Badge labels?
5 exports in one file: Count, Status, New, Beta and Tag. Each renders a native button and takes a size prop (sm, md, lg, xl) aligned to the base Button. They are separate from the base Button on purpose: the base keeps its clean variant, tone and size axes, while the styled layer carries the effects.
You own the file. Copy the one category file and you have all 5 variations, with no runtime dependency on ai2 itself.
Why use it
- On-system by construction: Every color resolves to an ai2 semantic token, so the buttons follow your theme in light and dark with no extra work.
- Effect without the sprawl: The decorations live in a dedicated styled file, so the base Button keeps its clean, predictable API.
- Accessible and honest: Each renders a real button element, keeps a visible focus ring, and respects prefers-reduced-motion.
Features
- Token-driven color: No hardcoded hex or oklch; the look recolors with your theme tokens.
- framer-motion: these labels are static, so no motion library work is required.
- Reduced-motion aware: Under prefers-reduced-motion, there is no motion to reduce.
- Size aligned to the base: Every variation takes sm, md, lg and xl matching the base Button height scale, so styled and base buttons line up in a row.
Production tips
- Use it for emphasis, not everywhere: Styled buttons draw the eye. Reserve them for the one action you want people to take on a screen, and use the base Button for the rest.
- Keep labels as verbs: The decoration adds weight, so a clear action label keeps the button scannable.
- Pick one variation per surface: The variations share a family; using two different ones in the same view competes for attention.
Works with the rest of ai2
The Badge labels sit alongside the base Button and the rest of the @ai2 registry. They share the same token file, so a styled action next to a base button or a badge stays visually consistent in both modes.