Timeline

A visual representation of events in chronological order.

Package

shadcn/ui

March 2024

Project Initialized

Successfully set up the project repository and initial architecture.

April 2024

Beta Release

Launched the beta version for early testers and feedback.

June 2024

Official Launch

The platform is now live for all users worldwide.

import {
  Timeline,
  TimelineContent,

Examples

With Left-Aligned Dates

Jan 2025

AI Engine Integration

Deep integration of advanced LLMs for real-time code generation and context-aware suggestions.

Feb 2025

Collaborative Editing

Multi-user real-time collaboration with shared cursors and instant synchronization across workspaces.

Mar 2025

Visual Theme Builder

Interactive interface for creating and managing custom design systems with automated CSS variable generation.

Apr 2025

Enterprise Security

Role-based access control, SOC2 compliance audit, and enhanced data encryption protocols.

import {
  Timeline,
  TimelineContent,

With Custom Indicators

Mar 15, 2024

Order Placed

Your order has been received and is being processed.

Mar 16, 2024

Payment Confirmed

Transaction successful. Preparing for shipment.

Mar 18, 2024

Shipped

Your package is on its way. Track your delivery.

Mar 20, 2024

Delivered

Package successfully delivered to the recipient.

import {
  Timeline,
  TimelineContent,

With Icons

Forked Repository

Forked the repository to create a new branch for development.15 minutes ago

Pull Request Submitted

Submitted PR #342 with new feature implementation. Waiting for code review.10 minutes ago

Comparing Branches

Received comments on PR. Minor adjustments needed in error handling.5 minutes ago

Merged Branch

Merged the feature branch into the main branch. Ready for deployment.Just now

import {
  Timeline,
  TimelineContent,

Alternating Layout

Jan 2024

Seed Funding

Mar 2024

Product MVP

May 2024

First Client

Jul 2024

Series A

Sep 2024

Global Expansion

import {
  Timeline,
  TimelineDate,

Horizontal Orientation

Source Code Checkout

12s

Successfully fetched latest changes from the main branch.

Dependency Installation

1m 45s

All npm packages installed and cached for future builds.

Unit & Integration Tests

Running

Running 142 test suites across the entire codebase...

Production Build

Pending

Optimizing assets and generating static site pages.

import { Badge } from "@blitz-ui/react"
import {
  Frame,

Horizontal with Top Indicators

Dec 15, 2025

Completed Beta Program

Nov 01, 2025

Completed Usability Testing

Oct 15, 2025

Initiated Design Phase

Aug 01, 2024

Completed Requirements Gathering

Jul 15, 2024

Started Project Kickoff

import {
  Timeline,
  TimelineContent,

Customized Timeline

Week 1

Planning

Scope definition and resource planning.

Week 2

Design

UI/UX design and prototyping.

Week 4

Development

Core features implementation.

import {
  Timeline,
  TimelineContent,

Compact Roadmap

Oct 2024

Kickoff

Defining project goals and core team selection.

Nov 2024

Discovery

User research and requirements gathering phase.

Dec 2024

Implementation

Core development and sprint execution.

"use client"

import {

Activity Feed

Production Deploy

success

a1b2c3d·main·42s

2 minutes ago

Staging Deploy

success

e4f5g6h·staging·38s

15 minutes ago

Preview Deploy

failed

i7j8k9l·feat/auth·1m 12s

1 hour ago

Production Deploy

success

m0n1o2p·main·45s

3 hours ago

import { Badge } from "@blitz-ui/react"
import {
  Timeline,

Installation


pnpm dlx shadcn@latest add @blitz-ui/timeline

Usage

import {
  Timeline,
  TimelineContent,
  TimelineDate,
  TimelineHeader,
  TimelineIndicator,
  TimelineItem,
  TimelineSeparator,
  TimelineTitle,
} from "@blitz-ui/react/timeline"

<Timeline>
  <TimelineItem step={1}>
    <TimelineHeader>
      <TimelineDate>March 2024</TimelineDate>
      <TimelineTitle>Project Initialized</TimelineTitle>
    </TimelineHeader>
    <TimelineIndicator />
    <TimelineSeparator />
    <TimelineContent>
      Successfully set up the project repository and initial architecture.
    </TimelineContent>
  </TimelineItem>
</Timeline>

API Reference

Timeline

The root component for the timeline.

Prop	Type	Default	Description
`defaultValue`	`number`	`1`	The initial active step.
`value`	`number`	-	The current active step (controlled).
`onValueChange`	`(value: number) => void`	-	Callback fired when the active step changes.
`orientation`	`"horizontal" \| "vertical"`	`"vertical"`	The layout orientation of the timeline.

TimelineItem

A single item in the timeline.

Prop	Type	Default	Description
`step`	`number`	-	Required. The step number for this item.

TimelineDate

The date or time label for a timeline item.

Prop	Type	Default	Description
`className`	`string`	-	Additional CSS classes for the date label.

TimelineTitle

The title for a timeline item.

Prop	Type	Default	Description
`className`	`string`	-	Additional CSS classes for the title.

TimelineIndicator

The visual indicator (usually a dot) for a timeline item.

Prop	Type	Default	Description
`className`	`string`	-	Additional CSS classes for the indicator.

TimelineSeparator

The line connecting timeline indicators.

Prop	Type	Default	Description
`className`	`string`	-	Additional CSS classes for the separator line.

TimelineHeader

A container for the date and title.

Prop	Type	Default	Description
`className`	`string`	-	Additional CSS classes for the header container.

TimelineContent

The main descriptive content for a timeline item.

Prop	Type	Default	Description
`className`	`string`	-	Additional CSS classes for the content container.

Textarea Toggle