# NUKnightLab/TimelineJS

TimelineJS: A Storytelling Timeline built in JavaScript.

Repository: https://github.com/NUKnightLab/TimelineJS
Canonical: https://ross.abutalabs.com/products/timelinejs
Homepage: http://timeline.knightlab.com
Language: JavaScript
License: NOASSERTION
License Family: other
Archived: true
Last push: 2022-05-11T20:13:40+00:00

## Health v2 (maintenance only)
Score: 10/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 5294, "days_push": 1575, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, archived, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 8937, forks 1522 (observed 2026-08-28T04:10:26.364420+00:00)

## What it is
TimelineJS is an open-source JavaScript library for building visually rich, interactive timelines that can be embedded in any website. Timelines can be authored via a Google Spreadsheet template or custom JSON, with automatic embedding of media from sources like YouTube, Twitter, Flickr, SoundCloud, and Google Maps.

## Use cases
- create an interactive timeline for a news story
- embed a timeline in a blog or website
- build a timeline from a Google spreadsheet
- visualize historical events chronologically
- add rich media to timeline slides
- make a timeline without coding

## When to choose
- you need a quick, no-code timeline from a Google spreadsheet
- you want automatic embedding of tweets, videos, maps, and audio
- you need a visually polished timeline embeddable on any site

## When to avoid
- you are starting a new project - use TimelineJS3 instead, since this version is no longer developed
- you need stories that jump around in time rather than a chronological narrative
- you need programmatic conversion of legacy JSON to the new format

## Facets
- artifact type: library
- maturity: abandoned
- function: data-visualization, ui-components, frontend-framework
- domain: data-visualization, web-development, media, education
- platform: browser
- tags: timeline, storytelling, google-spreadsheets, knight-lab, embeddable-widget, superseded, javascript, web-server

## Member repositories
- NUKnightLab/TimelineJS (main) score 10

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:26.364420+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-29T17:24:31.648259+00:00, confidence not recorded.
  - readme: https://github.com/NUKnightLab/TimelineJS (fetched 2026-08-28T04:10:26.364420+00:00, sha 04587605dcae)
  - homepage: http://timeline.knightlab.com (fetched 2026-08-29T08:25:09.763269+00:00, sha 8b02bd7f36a0)
  - site_page: http://timeline.knightlab.com/docs/using-spreadsheets.html (fetched 2026-08-29T08:25:09.767785+00:00, sha 8217e868afd9)
  - site_page: http://timeline.knightlab.com/docs/media-types.html (fetched 2026-08-29T08:25:09.770112+00:00, sha bf81173e2abe)
  - site_page: http://timeline.knightlab.com/docs/json-format.html (fetched 2026-08-29T08:25:09.772053+00:00, sha 0902948b3724)
  - site_page: http://timeline.knightlab.com/docs/overriding-styles.html (fetched 2026-08-29T08:25:09.773847+00:00, sha b3a86a5453e9)
  - site_page: http://timeline.knightlab.com/docs/options.html (fetched 2026-08-29T08:25:09.775742+00:00, sha a7a65c8fa96c)
  - site_page: http://timeline.knightlab.com/docs/instantiate-a-timeline.html (fetched 2026-08-29T08:25:09.777541+00:00, sha d7d6863c8e2d)
- Data as of 2026-08-30T08:39:29.467469+00:00.