- Accordion
- Attachment
- Avatar
- Badge
- Breadcrumb
- Button
- Button Group
- Card
- Checkbox
- Code Block
- Collapsible
- Dialog
- Dropdown Menu
- Empty
- Field
- Hover Card
- Input
- Input Group
- Input OTP
- Item
- Label
- Marker
- Message
- Number Flow
- Pagination
- Popover
- Progress
- Radio Group
- Select
- Slider
- Sonner
- Spinner
- Switch
- Tooltip
- Separator
- Sheet
- Tabs
- Textarea
- Toggle
- Toggle Group
- Trace
import type { VariantProps } from "class-variance-authority";
import { cva } from "class-variance-authority";
import type * as React from "react";
import { cn } from "@/lib/utils";
const markerVariants = cva(
"group/marker text-muted-foreground [a]:hover:text-foreground relative flex min-h-4 w-full items-center gap-2 text-left text-sm [&_svg:not([class*='size-'])]:size-4 [a]:underline [a]:underline-offset-3",
{
variants: {
variant: {
border: "border-border border-b pb-2",
default: "",
separator:
"before:bg-border after:bg-border before:mr-1 before:h-px before:min-w-0 before:flex-1 after:ml-1 after:h-px after:min-w-0 after:flex-1",
},
},
}
);
type MarkerProps = Omit<React.ComponentProps<"div">, "ref"> &
VariantProps<typeof markerVariants> & {
as?: React.ElementType;
ref?: React.Ref<HTMLDivElement>;
} & Record<string, unknown>;
function Marker({
className,
variant = "default",
as,
ref,
...props
}: MarkerProps) {
const Comp = as ?? "div";
return (
<Comp
className={cn(markerVariants({ className, variant }))}
data-slot="marker"
data-variant={variant}
ref={ref}
{...props}
/>
);
}
function MarkerIcon({ className, ...props }: React.ComponentProps<"span">) {
return (
<span
aria-hidden="true"
className={cn(
"size-4 shrink-0 [&_svg:not([class*='size-'])]:size-4",
className
)}
data-slot="marker-icon"
{...props}
/>
);
}
function MarkerContent({ className, ...props }: React.ComponentProps<"span">) {
return (
<span
className={cn(
"*:[a]:hover:text-foreground min-w-0 wrap-break-word group-data-[variant=separator]/marker:flex-none group-data-[variant=separator]/marker:text-center *:[a]:underline *:[a]:underline-offset-3",
className
)}
data-slot="marker-content"
{...props}
/>
);
}
export { Marker, MarkerContent, MarkerIcon, markerVariants };Marker is a small, single-line status row. Use it for system events, inline notifications, typing indicators, or as a separator between sections in a conversation.
Installation
$ bunx --bun frakment add marker$ npx frakment add marker$ pnpm dlx frakment add marker$ yarn dlx frakment add marker
Install the following dependency:
$ bun add class-variance-authority$ npm install class-variance-authority$ pnpm add class-variance-authority$ yarn add class-variance-authority
Copy and paste the following code into your project.
import type { VariantProps } from "class-variance-authority";
import { cva } from "class-variance-authority";
import type * as React from "react";
import { cn } from "@/lib/utils";
const markerVariants = cva(
"group/marker text-muted-foreground [a]:hover:text-foreground relative flex min-h-4 w-full items-center gap-2 text-left text-sm [&_svg:not([class*='size-'])]:size-4 [a]:underline [a]:underline-offset-3",
{
variants: {
variant: {
border: "border-border border-b pb-2",
default: "",
separator:
"before:bg-border after:bg-border before:mr-1 before:h-px before:min-w-0 before:flex-1 after:ml-1 after:h-px after:min-w-0 after:flex-1",
},
},
}
);
type MarkerProps = Omit<React.ComponentProps<"div">, "ref"> &
VariantProps<typeof markerVariants> & {
as?: React.ElementType;
ref?: React.Ref<HTMLDivElement>;
} & Record<string, unknown>;
function Marker({
className,
variant = "default",
as,
ref,
...props
}: MarkerProps) {
const Comp = as ?? "div";
return (
<Comp
className={cn(markerVariants({ className, variant }))}
data-slot="marker"
data-variant={variant}
ref={ref}
{...props}
/>
);
}
function MarkerIcon({ className, ...props }: React.ComponentProps<"span">) {
return (
<span
aria-hidden="true"
className={cn(
"size-4 shrink-0 [&_svg:not([class*='size-'])]:size-4",
className
)}
data-slot="marker-icon"
{...props}
/>
);
}
function MarkerContent({ className, ...props }: React.ComponentProps<"span">) {
return (
<span
className={cn(
"*:[a]:hover:text-foreground min-w-0 wrap-break-word group-data-[variant=separator]/marker:flex-none group-data-[variant=separator]/marker:text-center *:[a]:underline *:[a]:underline-offset-3",
className
)}
data-slot="marker-content"
{...props}
/>
);
}
export { Marker, MarkerContent, MarkerIcon, markerVariants };Update the import paths to match your project setup.
Usage
import { Marker, MarkerContent, MarkerIcon } from "@/components/ui/marker";<Marker>
<MarkerIcon>
<CheckIcon />
</MarkerIcon>
<MarkerContent>Saved just now</MarkerContent>
</Marker>Composition
Marker
├── MarkerIcon
└── MarkerContentExamples
Basic
The simplest form — just text.
import { Marker, MarkerContent } from "@/components/ui/marker";
export function MarkerBasic() {
return (
<div className="w-full max-w-sm">
<Marker className="mx-auto w-fit">
<MarkerContent>Conversation started</MarkerContent>
</Marker>
</div>
);
}With icon
Place MarkerIcon as the first child. The icon is sized to 16px.
import { CheckIcon, GitBranchIcon, SearchIcon } from "lucide-react";
import { Marker, MarkerContent, MarkerIcon } from "@/components/ui/marker";
export function MarkerWithIcon() {
return (
<div className="flex w-full max-w-sm flex-col gap-4">
<Marker className="mx-auto w-fit">
<MarkerIcon>
<GitBranchIcon />
</MarkerIcon>
<MarkerContent>Switched to a new branch</MarkerContent>
</Marker>
<Marker className="mx-auto w-fit">
<MarkerIcon>
<SearchIcon />
</MarkerIcon>
<MarkerContent>Explored 4 files</MarkerContent>
</Marker>
<Marker className="mx-auto w-fit">
<MarkerIcon>
<CheckIcon />
</MarkerIcon>
<MarkerContent>All checks passed</MarkerContent>
</Marker>
</div>
);
}Status
Set role="status" when the marker announces a live change. Pair with a spinner and shimmer for a streaming effect.
import { Marker, MarkerContent, MarkerIcon } from "@/components/ui/marker";
import { Spinner } from "@/components/ui/spinner";
export function MarkerStatus() {
return (
<div className="flex w-full max-w-sm flex-col gap-4">
<Marker className="mx-auto w-fit" role="status">
<MarkerIcon>
<Spinner />
</MarkerIcon>
<MarkerContent className="shimmer">Thinking...</MarkerContent>
</Marker>
<Marker className="mx-auto w-fit" role="status">
<MarkerIcon>
<Spinner />
</MarkerIcon>
<MarkerContent className="shimmer">Reading 4 files...</MarkerContent>
</Marker>
<Marker className="mx-auto w-fit" role="status">
<MarkerIcon>
<Spinner />
</MarkerIcon>
<MarkerContent className="shimmer">Running tests...</MarkerContent>
</Marker>
</div>
);
}Shimmer
Apply shimmer to MarkerContent for a gentle highlight animation. Combine with font-medium on a name to mimic a chat presence line.
import { Marker, MarkerContent } from "@/components/ui/marker";
export function MarkerShimmer() {
return (
<div className="flex w-full max-w-sm flex-col gap-4">
<Marker className="mx-auto w-fit">
<MarkerContent className="shimmer">
<span className="font-medium">Oliver</span> is typing...
</MarkerContent>
</Marker>
<Marker className="mx-auto w-fit">
<MarkerContent className="shimmer">
Generating response...
</MarkerContent>
</Marker>
</div>
);
}Separator
Set variant="separator" for a divider with a centered label.
import { Marker, MarkerContent } from "@/components/ui/marker";
export function MarkerSeparator() {
return (
<div className="flex w-full max-w-sm flex-col gap-6">
<Marker variant="separator">
<MarkerContent>Today</MarkerContent>
</Marker>
<Marker variant="separator">
<MarkerContent>Worked for 42s</MarkerContent>
</Marker>
<Marker variant="separator">
<MarkerContent>Conversation compacted</MarkerContent>
</Marker>
</div>
);
}Border
Set variant="border" for a status row with a bottom rule — useful as a section header.
import { GitBranchIcon } from "lucide-react";
import { Marker, MarkerContent, MarkerIcon } from "@/components/ui/marker";
export function MarkerBorder() {
return (
<div className="flex w-full max-w-sm flex-col gap-2">
<Marker variant="border">
<MarkerIcon>
<GitBranchIcon />
</MarkerIcon>
<MarkerContent>Switched to release-candidate</MarkerContent>
</Marker>
<Marker>
<MarkerContent>build started</MarkerContent>
</Marker>
</div>
);
}With time
Combine an icon with a muted duration. Use tabular-nums for aligned digits.
import { ClockIcon } from "lucide-react";
import { Marker, MarkerContent, MarkerIcon } from "@/components/ui/marker";
export function MarkerWithTime() {
return (
<div className="flex w-full max-w-sm flex-col gap-2">
<Marker className="mx-auto w-fit">
<MarkerIcon>
<ClockIcon />
</MarkerIcon>
<MarkerContent>Profiled in 1.8s</MarkerContent>
</Marker>
<Marker className="mx-auto w-fit">
<MarkerIcon>
<ClockIcon />
</MarkerIcon>
<MarkerContent>Deployed in 12.4s</MarkerContent>
</Marker>
</div>
);
}Links and buttons
Pass as="a" or as="button" to render the marker as an interactive element. The whole row becomes clickable and keyboard-focusable.
import { ChevronRightIcon, GitBranchIcon, SearchIcon } from "lucide-react";
import { Marker, MarkerContent, MarkerIcon } from "@/components/ui/marker";
export function MarkerLinks() {
return (
<div className="flex w-full max-w-sm flex-col gap-4">
<Marker as="a" href="#">
<MarkerIcon>
<GitBranchIcon />
</MarkerIcon>
<MarkerContent>View branch on GitHub</MarkerContent>
<ChevronRightIcon className="ms-auto size-4 opacity-50" />
</Marker>
<Marker as="button" type="button">
<MarkerIcon>
<SearchIcon />
</MarkerIcon>
<MarkerContent>Show all 4 explored files</MarkerContent>
<ChevronRightIcon className="ms-auto size-4 opacity-50" />
</Marker>
</div>
);
}In Context
Thinking marker
import { Marker, MarkerContent, MarkerIcon } from "@/components/ui/marker";
import { Spinner } from "@/components/ui/spinner";
export function MarkerInContext() {
return (
<div className="mx-auto flex w-full max-w-sm flex-col gap-3">
<Marker role="status">
<MarkerIcon>
<Spinner />
</MarkerIcon>
<MarkerContent>Thinking…</MarkerContent>
</Marker>
<Marker role="status" variant="separator">
<MarkerContent>Read 4 files</MarkerContent>
</Marker>
</div>
);
}API Reference
Marker
| Prop | Type | Default | Description |
|---|---|---|---|
variant | defaultborderseparator | — | Visual style of the row. |
as | React.ElementType | — | Render as a different element or component. Accepts tag names or React components. Defaults to div. |
MarkerIcon
Extends React.ComponentProps<"span">. Renders aria-hidden. Sizes child SVG to 16px unless overridden.
MarkerContent
Extends React.ComponentProps<"span">. Wraps inline links with underline and hover color. Add className="shimmer" for animated streaming text.
Data Attributes
| Attribute | Values |
|---|---|
data-slot | marker, marker-icon, marker-content |
data-variant | default | separator | border |
Accessibility
- Pass
role="status"toMarkerwhen it announces a live change (typing, syncing, running). MarkerIconisaria-hidden— the meaning lives inMarkerContent.- For interactive markers, use
as="a"for navigation andas="button"for actions so keyboard and screen readers behave correctly. - With
prefers-reduced-motion, the shimmer animation stops automatically.
Best Practices
- Use
variant="separator"for inline status. A horizontal rule with centered text reads as a divider. - Pair with an icon. A spinner or check clarifies the state.
- Keep text short. "Thinking" beats "The model is currently thinking".
- Announce with
role="status". Screen readers announce updates politely.