Timeline

Chronological events connected by a line.

When to use

Use a timeline for a chronological history, such as project updates or work experience. Use a Stepper for progress through an application task.

Default

Combine .timeline, .timeline-item and .timeline-dot. Add .is-active for the current item.

Place each .timeline-item directly inside its .timeline, with its .timeline-dot as a direct child of that item. Put event content in the adjacent content column.

  1. Frontend Architect

    2024 - today

    Building scalable frontend architectures, design systems and component libraries.

  2. Senior Frontend Developer

    2021 - 2024

    Developed modern web applications with Angular, TypeScript and SCSS.

  3. Web Developer

    2018 - 2021

    Created websites, landing pages and custom frontend solutions.

HTML
<ol class="timeline">
	<li class="timeline-item is-active">
		<div class="timeline-dot" aria-hidden="true"></div>

		<div>
			<div class="d-flex flex-wrap align-items-center gap-2 mb-1">
				<h3 class="mb-0">Frontend Architect</h3>
				<span class="badge bg-primary">2024 - today</span>
			</div>

			<p class="mb-0 text-muted">
				Building scalable frontend architectures, design systems and component libraries.
			</p>
		</div>
	</li>

	<li class="timeline-item">
		<div class="timeline-dot" aria-hidden="true"></div>

		<div>
			<div class="d-flex flex-wrap align-items-center gap-2 mb-1">
				<h3 class="mb-0">Senior Frontend Developer</h3>
				<span class="badge bg-primary">2021 - 2024</span>
			</div>

			<p class="mb-0 text-muted">
				Developed modern web applications with Angular, TypeScript and SCSS.
			</p>
		</div>
	</li>
</ol>

Numbered timeline

Add .timeline-numbered for numbered events or static processes. Use the Stepper for progress states.

Nest another .timeline inside an item’s content column. Each list keeps its own plain or numbered markers and active states; numbered lists restart at 1 without changing the outer sequence.

  1. Set up system

    Step 1

    Install and configure all required system dependencies.

  2. Test workflow

    Step 2

    Run the main workflow and check if all required steps are working.

  3. Go live

    Step 3

    Publish the final setup after testing has been completed.

HTML
<ol class="timeline timeline-numbered">
	<li class="timeline-item is-active">
		<div class="timeline-dot" aria-hidden="true"></div>

		<div>
			<div class="d-flex flex-wrap align-items-center gap-2 mb-1">
				<h3 class="mb-0">Set up system</h3>
				<span class="badge bg-primary">Step 1</span>
			</div>

			<p class="mb-0 text-muted">Install and configure all required system dependencies.</p>
		</div>
	</li>

	<li class="timeline-item">
		<div class="timeline-dot" aria-hidden="true"></div>

		<div>
			<div class="d-flex flex-wrap align-items-center gap-2 mb-1">
				<h3 class="mb-0">Test workflow</h3>
				<span class="badge bg-secondary">Step 2</span>
			</div>

			<p class="mb-0 text-muted">
				Run the main workflow and check if all required steps are working.
			</p>
		</div>
	</li>

	<li class="timeline-item">
		<div class="timeline-dot" aria-hidden="true"></div>

		<div>
			<div class="d-flex flex-wrap align-items-center gap-2 mb-1">
				<h3 class="mb-0">Go live</h3>
				<span class="badge bg-secondary">Step 3</span>
			</div>

			<p class="mb-0 text-muted">Publish the final setup after testing has been completed.</p>
		</div>
	</li>
</ol>

Accessibility and behavior

  • Use an ordered list when sequence matters and include meaningful event headings and dates. Keep the visual order consistent with the DOM.
  • Dots and connectors are decorative; hide repeated visual markers from assistive technology. Use visible text to explain any active or highlighted event.
  • Keep event actions as ordinary links or buttons. A numbered timeline is a static sequence and does not implement task navigation.

CSS variables

Override these base defaults on the listed selector after the library styles. Variants and states may replace them; global tokens follow the active theme.

TokenDefaultPurposeScope / state
--timeline-line-colorvar(--border-color)Default connector line color..timeline
--timeline-line-widthvar(--border-width)Connector thickness..timeline
--timeline-dot-size0.75remMarker diameter; numbered timelines replace it..timeline
--timeline-dot-offset-yvar(--spacer-3)Marker distance from the top of its item..timeline
--timeline-dot-center-ycalc(var(--timeline-dot-offset-y) + (var(--timeline-dot-size) / 2))Connector endpoint aligned with the marker center..timeline
--timeline-dot-colorvar(--border-color)Default marker background..timeline
--timeline-dot-active-colorvar(--primary)Active marker background..timeline
--timeline-dot-ring-colorvar(--bg-body)Outer marker ring color, masking the connector..timeline
--timeline-dot-ring-size0.25remOuter marker ring thickness..timeline
--timeline-gapvar(--spacer-3)Space between child elements..timeline
--timeline-item-padding-bottomvar(--spacer-4)Vertical space after each item except the last..timeline
--timeline-item-line-colorvar(--timeline-line-color)Connector color for an individual item..timeline-item
--timeline-dot-number-colorvar(--text-muted)Numbered marker text color..timeline-numbered
--timeline-dot-active-number-colorvar(--on-primary)Active numbered marker text color..timeline-numbered
--timeline-dot-border-widthvar(--border-width)Numbered marker border thickness..timeline-numbered
--timeline-dot-border-colorvar(--border-color)Numbered marker border color..timeline-numbered