React Horizontal Timeline screenshot

React Horizontal Timeline

Author Avatar Theme by Nixypanda
Updated: 7 Jan 2026
303 Stars

[Not maintained] A Timeline component

Categories

Overview

If you’re looking to integrate a visually engaging timeline into your web application, the React Horizontal Timeline could be just the solution you need. Developed as a React port of a popular horizontal timeline created by CodyHouse, this component allows developers to present dates in an orderly manner while providing interactive features to engage users. Whether you’re building a project timeline or showcasing historical events, this tool is versatile and easy to implement.

The Horizontal Timeline is not just about aesthetics; it offers a range of customizable properties that allow developers to tailor the component to fit their specific needs. With intuitive functionalities and responsive design, you can enhance the user experience in no time. Now, let’s delve into some of its key features that make this tool stand out.

Features

  • Dynamic Date Handling: Accepts a sorted array of dates in the yyyy-mm-dd format, allowing for effortless timeline creation.
  • Interactive Click Events: Notifies the index of the clicked date, enabling you to define custom actions based on user interaction.
  • Customizable Labels: Use the getLabel function to format event labels according to your preferences, enhancing clarity and usability.
  • Padding Control: Adjusts the spacing between event labels with minEventPadding and maxEventPadding for a polished look.
  • Animation Control: Fine-tune the appearance of animations with adjustable fillingMotion and slidingMotion settings for a smoother user experience.
  • Style Customization: Extensive style options to modify colors for background, foreground, and outlines, ensuring the timeline matches your design aesthetic.
  • Touch and Keyboard Accessibility: Fully supports touch interactions and keyboard navigation, catering to a wider audience and enhancing accessibility.
  • Open-ended Design: Options to show both the beginning and end of the timeline as open-ended, offering flexibility in presentation.

This component encapsulates a powerful yet simple approach to visualizing events over time, making it a worthy addition to any React application.