Antikythera Docs

Appearance

Changelog ​

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

v2.0.5 (27.07.2026) ​

Fixes ​

  • limited Export Markdown to the current entry so related article PDF cards cannot surface a Markdown download from a different article.
  • reduced excess bottom spacing in the desktop About column.

v2.0.4 (23.07.2026) ​

Stable v2 release ​

  • promoted the v2 redesign from release candidate to stable.
  • made expanded cover delivery responsive across viewport and pixel-density changes, with decode-aware readiness shared by the preload and mounted image.
  • optimized Sanity-backed expanded images and aligned PDF preview preload/display URLs.
  • retried transient API failures without permanently caching rejected requests, while preserving accurate error reporting.
  • fixed mobile view restoration, single-annotation scrolling, and expanded sticker clipping at tablet widths.
  • kept theme inversion and the 12-column debug grid development-only, backed by checks against both production entry bundles and emitted JavaScript/CSS.
  • added related-entry descriptions and Markdown assets to the full Nitro payload; the menu uses those descriptions but keeps related downloads PDF-only.

v2.0.0-beta (17.07.2026) ​

Major rework of the <antikythera-menu> web component and the entry API payload. The public JS API and component attributes are unchanged.

bash
npm install @antikythera/antikythera@beta
pnpm add @antikythera/antikythera@beta
bun add @antikythera/antikythera@beta
  • rebuilt the minimal and summary views around a new compact sticker with the Antikythera Journal wordmark.
  • replaced the Minimize/Expand/Summary nav controls with a More Info / Return to Article primary CTA.
  • reworked the fullscreen view into snap-scrolled pages for the entry, Related Articles, and About.
  • added an About page fed by the journal document (about text, aside text, contributors).
  • added a journal description card with the short description and settings external links.

Entry files ​

  • added a PDF preview download card and an Export Markdown button when the entry has a Markdown file.
  • PDF links open in a new tab; markdown downloads use the download attribute.
  • moved related entries into a dedicated expandable Related Articles section with full article cards and an explore-all-articles button.

Annotations ​

  • unified floating and inline annotation presentation.
  • added a desktop attribution toggle ("Annotations by …") that gates annotation cards.

API ​

  • added a top-level about object to GET /api/v1/entries/:id (journal about text, aside text, credits).
  • added markdown and formatted pdfPreview fields to the entry and metadata endpoints.
  • related entries now include their own pdf and pdfPreview.

Mobile & theming ​

  • sticky section headers, summary folding on article scroll, and improved expanded-layout resizing.
  • theme-aware stroke and gray CSS variables; base font size increased to 14px.
  • debug keyboard shortcuts: i inverts theme colors, g toggles a layout grid overlay.

v1.5.2 (20.05.2026) ​

Improvements ​

  • PostHog telemetry improvements.

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 persistent anonymous mode with sanitized URLs and constrained autocapture.
  • added PostHog tracing headers so browser pageviews and Nitro API events share stable anonymous distinct IDs and $session_id values.
  • 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.