Antikythera Docs

Appearance

Changelog ​

bash
npm install @antikythera/antikythera@latest
pnpm add @antikythera/antikythera@latest
bun add @antikythera/antikythera@latest

v1.5.1 (19.05.2026) ​

Improvements ​

  • added Sanity fields for API background and foreground color overrides.
  • returned apiBackgroundColor and apiForegroundColor from the Nitro entry and metadata endpoints.
  • added api-background-color and api-foreground-color component attributes for <antikythera-menu> and <antikythera-footer>.
  • moved menu and footer theming to shared CSS variables so text, icons, borders, muted text, and overlays inherit the same API color palette.
  • normalized plain hex color values and ignored unsafe or invalid CSS color inputs.

v1.5.0 (14.05.2026) ​

Analytics ​

  • added PostHog browser and Nitro API telemetry.
  • defaulted browser analytics to memory-only anonymous mode with sanitized URLs and constrained autocapture.
  • added full tracking mode and the ?telemetry debug flag.
  • added richer product event properties for annotations, links, sections, downloads, and host domains.

Bug Fixes ​

  • fixed flickering on sticker init with fade-in.
  • fixed ReferenceError: withoutSticker call.
  • changed folded annotation titles to use safe id lookup and getBoundingClientRect() instead of offsetTop.
  • fixed the CommonJS package export path for require().
  • guarded custom element registration so repeated Antikythera constructors do not throw.
  • removed stray console logs.

Improvements ​

  • Added optional runtime API host override via apiUrl.
  • Added support for api-url on <antikythera-menu> and <antikythera-footer>.
  • Added API URL normalization and validation; invalid overrides are ignored with a warning.
  • Added default API fallback to https://api.antikythera.org.
  • Included API host in request memoization cache keys to avoid cross-host cache collisions.
  • Added package version logging on Antikythera initialization.
  • Improved annotation scanning safety when annotation API responses are missing or malformed.

v1.3.8 (05.05.2025) ​

Minor fixes:

  • force hide antikythera-footer if no annotations && no credits.
  • removal of max-view annotation truncation.
  • improved removal of annotations after scrolling out of view.
  • improved loading transitions for mid titles.

v1.3.7 (03.05.2025) ​

Minor bug fixes to max view — tablet.

v1.3.6 (03.05.2025) ​

Minor bug fixes to max view — mobile.

v1.3.5 (01.05.2025) ​

Minor Version, adjustments to DOI loading, converting and to &.

v1.3.4 (30.04.2025) ​

Minor Version, small optional footer spacing adjustments.

v1.3.1 (29.04.2025) ​

Major Version release with bug fixes, updated styling and movement, released for production.

v1.3.0-beta.18 (24-29.04.2025) ​

Beta of Major Version release with bug fixes, updated styling and movement.

bash
npm install @antikythera/antikythera@beta
pnpm add @antikythera/antikythera@beta
bun add @antikythera/antikythera@beta

v1.2.0 (18.02.2025) ​

Minor Version release with dynamic article text scanning for Annotation injection and textStyle updates.

v1.1.0 (31.01.2025) ​

Minor Version release with new tablet breakpoint and adjusted top / left margin spacing.

v1.0.4 (07.11.2024) ​

Patch release fixing multiple contributor list logic.

v1.0.3 (24.10.2024) ​

Patch release to inset the sticker slightly on larger screen sizes (1.5rem). Mobile remails at .5rem.

v1.0.2 (22.10.2024) ​

Patch release to keep 3 lines reserved to avoid jump in card.

v1.0.1 (22.10.2024) ​

Patch release for expanded mobile font-size scaling for large monitors.

v1.0.0 (21.10.2024) ​

Production-ready release 🎉.

  • updated font loading due to web component @font-face constraints in Chrome and Firefox.