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.0
View changelog

What's Inside

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

histropediajs-1.3.0/
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.0 4th Dec 2025

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