Skip to content

    Browse components

    Timeline

    Vertical timeline whose glowing progress line fills as you scroll, lighting up markers and revealing entries.

    Open
    Customize

    Installation

    npx shadcn@latest add @glint-ui/timeline

    First time using @glint-ui? Add the registry to components.json once, or install by URL: npx shadcn@latest add https://glintui.vercel.app/r/timeline.json

    Usage

    import { Timeline } from "@/components/ui/timeline";
    
    <Timeline
      scrollContainerRef={scrollerRef}
      items={[
        { date: "Jan 2025", title: "First commit", description: "Where it all began." },
        { date: "Jul 2025", title: "v1.0 launch" },
      ]}
    />

    Props

    PropTypeDefaultDescription
    itemsReactNode—Array of { date, title, description?, icon? }.
    scrollContainerRefReactNode—Ref to the scrolling element. Defaults to the window.
    anchornumber0.5Viewport position of the progress head (0 top, 1 bottom).
    colorstring"#a3e635"Progress line and marker color.
    distancenumber24Px entries slide up while fading in.
    classNamestring—Extra classes for the root element.