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.
Frontend Architect
2024 - todayBuilding scalable frontend architectures, design systems and component libraries.
Senior Frontend Developer
2021 - 2024Developed modern web applications with Angular, TypeScript and SCSS.
Web Developer
2018 - 2021Created websites, landing pages and custom frontend solutions.
<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.
Set up system
Step 1Install and configure all required system dependencies.
Test workflow
Step 2Run the main workflow and check if all required steps are working.
Go live
Step 3Publish the final setup after testing has been completed.
<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.
| Token | Default | Purpose | Scope / state |
|---|---|---|---|
--timeline-line-color | var(--border-color) | Default connector line color. | .timeline |
--timeline-line-width | var(--border-width) | Connector thickness. | .timeline |
--timeline-dot-size | 0.75rem | Marker diameter; numbered timelines replace it. | .timeline |
--timeline-dot-offset-y | var(--spacer-3) | Marker distance from the top of its item. | .timeline |
--timeline-dot-center-y | calc(var(--timeline-dot-offset-y) + (var(--timeline-dot-size) / 2)) | Connector endpoint aligned with the marker center. | .timeline |
--timeline-dot-color | var(--border-color) | Default marker background. | .timeline |
--timeline-dot-active-color | var(--primary) | Active marker background. | .timeline |
--timeline-dot-ring-color | var(--bg-body) | Outer marker ring color, masking the connector. | .timeline |
--timeline-dot-ring-size | 0.25rem | Outer marker ring thickness. | .timeline |
--timeline-gap | var(--spacer-3) | Space between child elements. | .timeline |
--timeline-item-padding-bottom | var(--spacer-4) | Vertical space after each item except the last. | .timeline |
--timeline-item-line-color | var(--timeline-line-color) | Connector color for an individual item. | .timeline-item |
--timeline-dot-number-color | var(--text-muted) | Numbered marker text color. | .timeline-numbered |
--timeline-dot-active-number-color | var(--on-primary) | Active numbered marker text color. | .timeline-numbered |
--timeline-dot-border-width | var(--border-width) | Numbered marker border thickness. | .timeline-numbered |
--timeline-dot-border-color | var(--border-color) | Numbered marker border color. | .timeline-numbered |