Theme & dark-mode products

How the organization splits doc-site chrome and dark mode across repositories.

Product map

Product Role Install shape

valentus-theme

Composed doc-site chrome (mast, header, layout, VCS icons) with bundled dark mode

Release ui-bundle.zip as ui.bundle (usual full-stack install)

antora-dark-mode

Dark mode only — toggle, FOUC prevention, CSS overlay

supplemental_files or ui-module on another theme / Default UI; optional convenience zip for Default UI alone

antora-dark-theme (retired)

Former monolithic package (chrome + dark in one name)

Do not use. Migrate to Valentus (full) or antora-dark-mode (overlay)

Choose quickly

  • Need sticky header, breadcrumb mast, and dark toggle together → valentus-theme

  • Already happy with Default UI (or another theme) and only want a dark toggle → antora-dark-mode

  • Still pinning antora-dark-theme URLs or a personal fork of that name → migrate (see below)

Do not put Valentus in ui.bundle and also layer antora-dark-mode on top — Valentus already includes dark mode.

Canonical docs

GitHub topic strings (gallery)

The theme gallery uses prescribed topics such as antora-dark-theme and antora-dark-mode for appearance filters. Those topic strings are not the retired npm/package name — they describe capability (full dark theme vs slipstream overlay). See the themes-site user guide on GitHub topics.

See also