RELEASE_HISTORY

Changelog

What's shipped, as it ships. See what's planned next in the roadmap spreadsheet — feel free to leave comments there.

Nov 15, 2026

@audioguidekit/schema on npm

New

The data contract of the player is now a package: npm install @audioguidekit/schema. It has the types, the JSON Schemas, validateManifest and the field descriptions an editor is built from, for anyone whose tool writes tours or manifests. Read the docs.

Guided route or free exploration

New

A new tourStructure setting. A guided route (the default) numbers its stops, plays them one after another and draws the route line. Free exploration is for museums and galleries: visitors start each stop themselves, with no numbers and no route line, and the transition sound marks the end of a stop. Read the docs.

Playback speed, stop search, text size, subtitles and directions

New

Visitors can listen at 0.75x to 2x, search the stop list (shown from 9 stops), make texts larger in three steps, turn on video subtitles (WebVTT, also offline) and open a stop in Google Maps, Apple Maps or Waze. Each control has a tour setting to switch it off. A new app setting, embedAllowlist, limits which sites embed stops may show. Read the docs.

Privacy-friendly analytics

New

The player can count visits anonymously: no cookies, no user ids, nothing sent to third parties. Browsers with Global Privacy Control or Do Not Track are never counted, and "analytics": false switches it off. Standard builds send nothing until you set your own endpoint. Read the docs.

Manifest mode and the schema package

New

Build the player once and load its tours from a manifest.json at runtime, so publishing content needs no rebuild. Editors can show a live preview in a frame. The new @audioguidekit/schema package holds the types, JSON Schemas, manifest validation and field descriptions for tools that write manifests. Read the docs.

Self-hosted fonts and safer embeds

Improved

Fonts are bundled with the player, so it makes no requests to Google Fonts. Embed stops follow stricter rules: https only, and the YouTube and Spotify sandbox only for their own hosts. Downloads for offline use are more reliable. Read about fonts.

Hand-authored tours are kept

Fixed

Running dev or build no longer deletes tours you wrote by hand in src/data/tour.

Sep 12, 2026

Multiple tours in one app

New

Ship several tours from a single deployment. Visitors get a themeable tour-selection screen with app-level branding (logo, hero, splash), and each tour keeps its own map, marker, and route configuration. Read the docs or try the New York demo.

Per-tour map marker and route colors

New

With the introduction of multiple tours in one app, we added support for per-tour marker overrides (color, weight, opacity, dash pattern) – this lets you restyle a tour's markers and route line to match its own basemap or branding – no new theme required.

OpenFreeMap replaces Carto as default provider

Improved

The map now defaults to OpenFreeMap, so map view renders out of the box with no API key or usage quota to configure.

Bring your own vector map style

New

The map now renders vector tiles natively alongside the existing raster providers. Bring your own map style as style.json file to render a fully custom vector basemap, crisp at every zoom level, with no tile server of your own to run.

Jun 6, 2026

Outdoor guides with map view

New

Outdoor tours are now supported with a full map view, marker styles, and list/map combination modes.

Feb 2026

Better offline playback

Improved

Improved reliability of offline audio playback so guides keep working without a connection once downloaded.

Customizable layout options

New

Added support for different layout options for the main UI and player, selectable per deployment.

Themes support

New

The player enables you to define your own theme and branding. By default, it ships with customizable light and dark themes out of the box.

Released v1.0.0

Release

First stable release of the audio guide player.