For the complete documentation index, see llms.txt. Markdown variants are available by appending .md to any URL or sending an Accept: text/markdown header. An agent skill is available at /.well-known/agent-skills/site-skill.md.
FrakmentFrakment

Marker

A small inline status row with icon, content, and separator variants.

Web
Frakment
Switched to a new branch
Thinking...
Conversation compacted
Explored 4 files
marker.tsx
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

Usage

marker.tsx
import { Marker, MarkerContent, MarkerIcon } from "@/components/ui/marker";
tsx
<Marker>
  <MarkerIcon>
    <CheckIcon />
  </MarkerIcon>
  <MarkerContent>Saved just now</MarkerContent>
</Marker>

Composition

Marker
├── MarkerIcon
└── MarkerContent

Examples

Basic

The simplest form — just text.

Conversation started
marker-basic.tsx
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.

Switched to a new branch
Explored 4 files
All checks passed
marker-with-icon.tsx
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.

Thinking...
Reading 4 files...
Running tests...
marker-status.tsx
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.

Oliver is typing...
Generating response...
marker-shimmer.tsx
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.

Today
Worked for 42s
Conversation compacted
marker-separator.tsx
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.

Switched to release-candidate
build started
marker-border.tsx
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.

Profiled in 1.8s
Deployed in 12.4s
marker-with-time.tsx
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>
  );
}

Pass as="a" or as="button" to render the marker as an interactive element. The whole row becomes clickable and keyboard-focusable.

View branch on GitHub
marker-links.tsx
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

Thinking…
Read 4 files
marker-in-context.tsx
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

PropTypeDefaultDescription
variant
defaultborderseparator
—Visual style of the row.
asReact.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

AttributeValues
data-slotmarker, marker-icon, marker-content
data-variantdefault | separator | border

Accessibility

  • Pass role="status" to Marker when it announces a live change (typing, syncing, running).
  • MarkerIcon is aria-hidden — the meaning lives in MarkerContent.
  • For interactive markers, use as="a" for navigation and as="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.
  • Badge — compact label
  • Spinner — loading indicator