JavaScript Library for Circular Timeline Visualizations Build year-at-a-glance timelines in 5 minutes. Zero dependencies, works everywhere.
Why circular? Year-long projects fit in half the space and patterns jump out visually. Linear timelines waste screen real estate and hide cyclical patterns.
Templates sent to your inbox. No spam, unsubscribe anytime.
Built For Every Timeline
Whether you're planning quarterly goals, launching products, or tracking personal projects
Business Planning
Quarterly roadmaps, annual goals, and strategic milestones. See your entire year at a glance.
Product Launches
Pre-launch planning, go-to-market phases, and post-launch momentum tracking all in one view.
Content Planning
Editorial calendars with publishing schedules, content types, and multi-channel distribution.
Project Management
Multiple projects running in parallel with overlapping phases, dependencies, and milestones.
Academic Planning
Semesters, exam periods, holidays, and assignment deadlines for students and institutions.
Team Coordination
HR cycles, hiring windows, team events, training, and company milestones throughout the year.
Try It Live—No Install Required
Edit the code and watch your timeline update instantly. Interact with the preview, modify values, add rings.
Frequently Asked Questions
Everything you need to know about Circalify
Circular timelines work well when you're visualizing cyclical data—things that repeat annually like quarterly goals, seasonal trends, fiscal calendars, or content schedules. If you find yourself scrolling left and right to see Q4 while planning Q1, circular layouts solve that.
For one-off projects with clear start and end dates (like a product launch timeline or historical events), stick with linear timelines.
About 30 seconds with the CDN. If you're using npm, maybe a minute.
Add a <div> to your HTML, drop in the library, copy one of the examples from the docs, and you're running. The templates are just HTML files you can open and customize directly.
Yes! Circalify is MIT licensed and open source. The entire library is free for personal, commercial, and any other use without restrictions.
Every aspect is customizable—colors, fonts, sizes, spacing, and animations. Use the configuration options or apply custom CSS for complete control.
Absolutely! The MIT license allows unrestricted use in commercial projects. No attribution required, though always appreciated!
Immediately: 10 professional timeline templates as HTML files ready to customize. Includes quarterly planning, product roadmaps, editorial calendars, event planning, HR cycles, academic planners, and more.
Ongoing: Monthly showcases of creative timeline designs and implementation tips to help you build better visualizations. No spam, unsubscribe anytime.
We welcome contributions! Check out our GitHub repository to report issues, submit pull requests, or discuss feature ideas. Star the repo to show your support!
Get Started in 30 Seconds
Install via npm or use the CDN - your choice
$ npm install circalify
import CircularTimeline from 'https://unpkg.com/circalify@latest/src/index.js';
// Create your timeline
const timeline = new CircularTimeline('#timeline', {
startYear: 2025,
rings: [
{ type: 'calendar' },
{ type: 'data', name: 'Events' }
]
});
// Add your data
timeline.setData([
{ label: 'Launch', startDate: '2025-03-15', endDate: '2025-03-15' }
], 'Events');
Get Started
npm install circalify