Download HistropediaJS

Free for personal, educational, and other non-commercial projects — Zero-dependency UMD and ES module builds.

Get Started View Licence

Choose Your Setup

Use a script tag or bundle the ES module. Histropedia ships with zero dependencies.

Use a Script Tag

Drop the UMD build on any page and go.

<script src="./histropedia.umd.js"></script>
<script>
  // Make timeline magic...
</script>

Bundle as a Module

Import the ES module build in modern toolchains.

<script type="module">
  import Histropedia from './histropedia.esm.js';
  // Make timeline magic...
</script>

Free for Non-Commercial Use

By downloading and using this software, you acknowledge your understanding and acceptance of the HistropediaJS Non-Commercial Licence Agreement.

View Licence

Required to enable the download.

Download HistropediaJS
Latest: v1.3.3
View changelog

What's Inside

Everything you need to start building timelines, bundled into a .zip download.

histropediajs-1.3.3/
dist/ Production builds
UMD Use with <script> tags
  • histropedia.umd.min.js 115 kB ~34 kB gzip
  • histropedia.umd.min.js.map source map
  • histropedia.umd.js unminified
ESM Use with modern bundlers
  • histropedia.esm.min.js 150 kB ~39 kB gzip
  • histropedia.esm.min.js.map source map
  • histropedia.esm.js unminified
TS TypeScript definitions
  • histropedia.esm.d.ts
  • histropedia.umd.d.ts
demo/ Working examples

Complete UMD and ESM examples with shared data — copy, paste, and customize.

Gzip sizes for reference — most servers compress automatically

What's New

Highlights from the latest release. For full notes, see the links below or the change log.

Version 1.3.3 4th Feb 2026

Fixes

  • Time Band opacity bleed – resets the canvas globalAlpha at the start of each Time Band draw so the overlay does not inherit the last rendered article's fade opacity when it has no image.
Version 1.3.2 25th Jan 2026

Fixes

  • Legacy event handler this context – preserves the timeline instance as this inside legacy event handlers to maintain backward compatibility.
Version 1.3.1 18th Dec 2025

Fixes

  • HiDPI shadows – aligns shadow dimensions with the canvas DPR for consistent size on high-density displays.
  • Card border toggles – prevents landscape cards from drawing borders when border width is set to 0.
  • Card height refresh – recalculates card height when border width changes to fix bottom alignment.
Version 1.3.0 4th Dec 2025

v1.3.0 release blog post

Highlights

  • Zero dependencies – now only a single HistropediaJS file required.
  • Card layouts – landscape layout and the ability to register custom layouts.
  • Time Bands – highlight and label different time periods on the timeline.
  • Event system – new EventManager API with 18 events.
  • HiDPI support – configurable high-resolution canvas rendering.
  • Image loading – redesigned loader and cache for a massive performance boost.
  • Zoom options – smooth trackpad scrolling with automatic detection.
  • TypeScript – full type definitions for IDE autocompletion and type safety.

Read the Docs

Explore configuration, methods and best practices.

Documentation

See Examples

Live demos of common setups and patterns.

Examples