Ballmac UI home

Timeline

A composable sequence of milestones with current and complete states, dates, and connectors.

  1. Brief approved

    Scope and success criteria confirmed.

  2. Design review

    Components are ready for feedback.

  3. Publish

    Ship the approved experience.

Installation

$ pnpm dlx shadcn@latest add @ballmac/timeline

Usage

import { Timeline, TimelineItem, TimelineMarker, TimelineContent, TimelineTitle, TimelineDescription, TimelineTime, TimelineConnector } from "@/components/ballmac/timeline"

The full example is in the Code tab above.

Examples

States and variants

  1. Build passed

  2. Deploying preview

API reference

<Timeline>

PropTypeDefault
compact

Use a dense layout for log-like content.

booleanfalse

<TimelineItem>

PropTypeDefault
current

Whether this item is the current step.

booleanfalse
complete

Whether this item has completed.

booleanfalse

Also accepts the standard attributes of its root element.

Accessibility

KeyAction
NoneStatic content is announced with semantic structure

Use with AI

A composable sequence of milestones with current and complete states, dates, and connectors. With the shadcn MCP server set up (guide), ask your agent:

Add the Ballmac UI Timeline (@ballmac/timeline) to this project with the shadcn MCP, then use it where it fits.

Use it for

  • Show milestones or a chronological process

Not for

  • Use Activity Feed for a compact actor log

Registry JSON: https://ui.ballmac.com/r/timeline.json

Credits

Free to use in personal and commercial projects.

npm
None
Registry
shadcn/utils