jekyll-timeline
A jekyll-timeline demo: a vertical timeline with colored icon nodes and event entries.
Open Source Plugin ∙

jekyll-timeline

A Jekyll plugin that adds timeline and event block tags for building a vertical timeline in plain HTML and CSS.

jekyll-timeline adds timeline and timeline_event block tags so you can put a vertical timeline in any post or page. The output is plain HTML and CSS, with no JavaScript and no external dependencies. You can use Font Awesome, any CSS icon library with class-based icons, or emoji. Each event can have its own color, and you can sort the timeline ascending or descending.

Installation

Add to your Gemfile:

gem "jekyll-timeline"

Add to _config.yml:

plugins:
  - jekyll-timeline

Run bundle install, then copy _timeline.scss into your site’s SCSS directory and import it.

Usage

{% timeline %}

{% timeline_event date="January 2024" title="Project launched" icon="fa-rocket" %}
Shipped the first public release after six months of development.
{% endtimeline_event %}

{% timeline_event date="March 2024" title="1,000 users" icon="fa-users" color="#2ecc71" %}
Crossed 1,000 active users and added team management features.
{% endtimeline_event %}

{% timeline_event date="June 2024" title="v2.0 released" icon="fa-bolt" %}
Complete rewrite with improved performance and a new API.
{% endtimeline_event %}

{% endtimeline %}

Use order="desc" to flip it to reverse chronological order:

{% timeline order="desc" %}...{% endtimeline %}

Icon Support

The icon= attribute accepts:

  • CSS icon library classes: icon="fa-rocket" (gets your configured prefix added) or icon="fa-brands fa-github" (explicit classes). Works with Font Awesome, Phosphor, Material Symbols, or any library that uses CSS classes.
  • Emoji: icon="🚀"
  • Left out: renders a neutral dot

Set the default icon prefix in _config.yml:

timeline:
  default_icon_prefix: "fa-duotone fa-solid"

Demo

2020
Downtown Master Plan adopted

City Council adopted the 10-year Downtown Master Plan, establishing priorities for streetscape improvements, mixed-use development, and public space activation.

2021
Façade grant program launched

DDA launched the façade improvement grant program. 12 businesses received awards in the first year, with $180,000 in private investment leverage.

2022
Main Street reconstruction complete

Completed the $4.2M Main Street infrastructure project: new sidewalks, decorative lighting, street trees, and underground utility relocation.

2023
Historic mill redevelopment breaks ground

Private developer broke ground on the adaptive reuse of the 1920s textile mill into 84 mixed-income apartments and 6,000 sq ft of ground-floor retail.

2024
Downtown vacancy rate drops to 8%

Downtown commercial vacancy fell from 22% in 2020 to 8%, the lowest level since tracking began. Net new businesses: 31.

Styling

Change the look with CSS custom properties:

:root {
  --timeline-line-color: #dee2e6;
  --timeline-icon-bg: #6c757d;
  --timeline-icon-color: #fff;
  --timeline-date-color: #6c757d;
  --timeline-title-color: inherit;
  --timeline-body-color: inherit;
}