Antora, taken to the next level
antora-supplemental
The Antora project focuses on the core documentation toolchain. This organization hosts the GitHub-native assets, themes, and community tooling that fill the gaps.
Philosophy
Stay complementary. Ship what Antora has declined to maintain on GitHub, prototype in forks when upstream change is the goal, and keep ecosystem projects discoverable without forking the core project’s mission.
- Supplemental, not competing. We build Actions, templates, UI overlays, and registries that sit beside Antora — not alternate cores.
- GitHub-shaped gaps. Official Antora lives on GitLab and does not maintain GitHub Actions or repository templates. We do.
- Upstream when it matters. Forks exist to experiment and contribute back; long-lived divergence is a last resort, not a brand.
- Composable docs chrome. Prefer overlays and modules (dark mode, themes, registries) over monolithic “replace everything” bundles.
Notable contributions
Projects the community reaches for when publishing Antora on GitHub Pages, theming sites, or finding extensions.
- antora-dark-mode Dark mode overlay for Antora UI — toggle, FOUC prevention, CSS overrides without owning
ui.bundle. - valentus-theme Composed doc-site chrome with bundled dark mode for sites that want a full UI stack.
- antora-build-action Lean GitHub Action to build Antora and hand off to the official Pages deploy flow.
- antora-github-deploy-template Repository template: playbook, docs layout, and Actions → GitHub Pages in one place.
- antora-extensions-registry Ecosystem catalog (extensions, themes, UI modules) — registry.antora-supplemental.org.
- docs Organization documentation hub — docs.antora-supplemental.org.
- architexture-theme Bespoke architectural Antora theme with light/dark demo pages.
- dprint-plugin-asciidoc Format AsciiDoc with dprint (WASM / npm) for consistent source trees.
News
Releases and progress in a direct voice. Full archive on the news desk; longer arguments on the blog.
- `antora serve` stays supplemental — for now
Upstream closed #1202. The live preview loop ships as antora-serve. Full argument on the blog; here is the tracker progression and where things stand.
- Unversioned component URLs
The former alias-component-to-latest extension is now unversioned-component-urls — choose selector (default) or alias-to-latest for bare /component/ paths.
- The welcome site is live — and it has a news desk
antora-supplemental.github.io is the organization front door, now with a news feed for releases and hard calls.
- Stop pasting the “latest” redirect. Install it.
alias-component-to-latest packages Antora’s component-to-latest redirect so versioned sites install it instead of copy-pasting.
Contributing
List an Antora extension, theme, or UI module in the registry so people can find it. The GitHub organization is where this org’s tooling is built.