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, hard calls, and the thinking behind the stack — in a direct voice. Full archive on the news desk.
- 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.
- Valentus: chrome that fixes the defaults
Valentus is composed Antora doc-site chrome with bundled dark mode — and practical fixes for Default UI and Lunr pain.
- `antora serve` was declined. We shipped it anyway.
antora-serve brings generate, serve, watch, and live-reload for Antora playbooks. Optional dirty-set rebuilds via antora-incremental.
Docs and registry
Guides live on the documentation hub. Discover extensions, themes, and UI modules in the ecosystem registry.
docs.antora-supplemental.org registry.antora-supplemental.org GitHub org