Newsletter
Join the Community
Subscribe to our newsletter for the latest news and updates
Timeline / Résumé Theme with Jekyll
A customizable Jekyll portfolio theme with about, portfolio, and tools sections, easily configured via _config.yml.
Jekyll Timeline is an open-source Jekyll theme that visualizes time-structured data as a vertical timeline, most commonly used as a résumé page. It turns simple markdown files into a clean, date-ordered timeline and is designed to run on GitHub Pages with no server-side dependencies.
Jekyll Timeline is a Jekyll theme that accepts markdown files with frontmatter fields (title, date, optional enddate) and outputs a static web page displaying those entries as a chronological timeline. The project is authored by Lukas H. and released under the MIT license. It uses Liquid templates and the Jekyll collection feature to organize content, and the generated site can be hosted on GitHub Pages or any Jekyll-compatible static host.
_steps collection; only title and date are mandatory, while enddate enables range entries.https://USERNAME.github.io/REPO._config.yml file exposes the site title, background color, URL, and baseurl so you can match your brand.Jekyll Timeline is aimed at developers, job seekers, researchers, and hobbyists who want to present chronological information without building a custom layout. Job seekers can turn their work history into a visual résumé; researchers can list publications and milestones; developers can document project evolution; and history buffs can create timelines of people or events. Because the input is plain markdown, anyone comfortable editing text files can use it.
Setup is a four-step process: fork the repository, enable GitHub Pages in the repository settings, edit the markdown files inside the _steps folder, and then update _config.yml with your title, color, URL, and baseurl. Required frontmatter for each file is title and a date in the format 2016-09-31 00:00:00 -0700, though only year and month are displayed. An optional enddate adds a range line.
Jekyll Timeline is free and open source under the MIT License. There are no fees, subscriptions, or premium tiers; you only pay for GitHub Pages hosting if your repository exceeds free-tier limits.
Yes, the theme is released under the MIT license, so it is free to use, modify, and distribute for personal or commercial projects.
Fork the repository, go to Settings → Pages, select the branch you want to build from, and then edit the _steps files and _config.yml. Once the config baseurl matches your repository name, the site appears at https://USERNAME.github.io/REPO.
Each markdown file in _steps must contain title and date in its frontmatter. The date must include timezone offset, but only year and month are displayed. An optional enddate can be added for entries that span a period.
Yes, edit the color variable in _config.yml. The theme uses that value as the site's background color.
It is built with standard Jekyll, so it should build on any Jekyll-compatible host, not just GitHub Pages. You may need to adjust baseurl for your deployment path.
