RCA-2026-04-01-001: Fix Applied

Resolution

Immediate Actions

  1. Added dark-theme rules for all Antora wrapper containers:

    .dark-theme .body,
.dark-theme .main,
.dark-theme .main-content,
.dark-theme .content,
.dark-theme .article,
.dark-theme .doc,
.dark-theme .doc-main {
  background-color: var(--domus-base);
  color: var(--domus-text);
}

  2. Added toolbar, breadcrumbs, edit-this-page, home-link, and nav-toggle styling:

    .dark-theme .toolbar {
  background-color: var(--domus-base);
  border-bottom: 1px solid var(--domus-surface0);
}

.dark-theme .breadcrumbs a {
  color: var(--domus-subtext);
}

.dark-theme .edit-this-page a {
  color: var(--domus-subtext);
}

  3. Forced admonition inner table elements to transparent:

    .dark-theme .admonitionblock table,
.dark-theme .admonitionblock table tbody,
.dark-theme .admonitionblock table tr,
.dark-theme .admonitionblock table td {
  background-color: transparent !important;
  border: none;
}

  4. Styled the nav-panel-explore (component/version selector):

    .dark-theme .nav-panel-explore,
.dark-theme .nav-panel-explore .context,
.dark-theme .nav-panel-explore .components {
  background-color: var(--domus-mantle);
}

  5. Added FOUC prevention in head-meta.hbs:

    <script>
(function(){
  var s=localStorage.getItem('theme'),
      d=window.matchMedia('(prefers-color-scheme: dark)').matches;
  if(s==='dark'||(!s&&d))
    document.documentElement.classList.add('dark-theme')
})();
</script>

Verification

# Rebuild site
cd docs && npx antora antora-playbook.yml

# Serve and inspect
python3 -m http.server 8000 -d build/site

# Browser DevTools verification:
# 1. Open Elements panel
# 2. Inspect each container div for background-color
# 3. Confirm no element shows white (#fff or #fafafa)
# 4. Check admonition inner <table> shows transparent
# 5. Check nav-panel-explore at sidebar bottom
# 6. Hard refresh (Ctrl-Shift-R) to verify no FOUC