# NUKnightLab/TimelineJS3

TimelineJS v3: A Storytelling Timeline built in JavaScript.  http://timeline.knightlab.com

Repository: https://github.com/NUKnightLab/TimelineJS3
Canonical: https://ross.abutalabs.com/products/timelinejs3
Language: JavaScript
License: MPL-2.0
License Family: copyleft
Last push: 2026-08-11T13:58:24+00:00

## Health v2 (maintenance only)
Score: 76/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 97, release rhythm 35, longevity 100
- inputs: {"age_days": 4418, "days_push": 22, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3213, forks 646 (observed 2026-08-28T04:07:49.434392+00:00)

## What it is
TimelineJS is a JavaScript library for building interactive, media-rich storytelling timelines that can be embedded in web pages via an iframe snippet or instantiated directly with its API. It is maintained by Northwestern University Knight Lab and aimed at users with minimal technical skill, with plugins for WordPress, MediaWiki, and Drupal.

## Use cases
- create an interactive timeline of historical events for a website
- embed a story timeline in a WordPress or Drupal article
- build a timeline from a Google Sheet without coding
- visualize a project or company history with photos and videos
- add a scrollable chronological narrative to a news story

## When to choose
- you need an embeddable, media-rich timeline with minimal coding
- you want non-technical users to author timelines via a spreadsheet or web tool
- you need a mature, widely used storytelling timeline widget

## When to avoid
- you need a general-purpose charting or Gantt-chart library
- you require a fully tested programmatic API for deep customization
- you need server-side rendering or a framework-native component

## Facets
- artifact type: library
- maturity: stable
- function: data-visualization, ui-components, frontend-framework
- domain: data-visualization, web-development, frontend, education
- platform: browser
- tags: timeline, storytelling, embeddable-widget, javascript-library, history, cms-plugins, web-server, javascript

## Member repositories
- NUKnightLab/TimelineJS3 (main) score 76

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:49.434392+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T07:24:41.725219+00:00, confidence not recorded.
  - readme: https://github.com/NUKnightLab/TimelineJS3 (fetched 2026-08-28T04:07:49.434392+00:00, sha aad97a5aa1b1)
  - registry_npm: https://registry.npmjs.org/timelinejs3 (fetched 2026-08-29T09:38:23.390533+00:00, sha aff85a2b4124)
- Data as of 2026-08-30T08:39:29.467469+00:00.