Repository navigation
createConfig() silently drops opts.head — OG/Twitter meta never emitted on any product docs #6
Description
Repo: codecoradev/codecora-theme · Pinned by: every product docs site (uteke, covecto, …) via github:codecoradev/codecora-theme#<sha>
Bug
createConfig() interface declares:
/** Extra VitePress head tags (merged after theme defaults). */
head?: UserConfig['head']…but the returned defineConfig({ head: [...] }) is a hardcoded array (preconnect ×2, Google Fonts stylesheet, theme-color, accent style). opts.head is never read — anything a product passes is silently dropped.
Impact (verified live 2026-10-05)
- covecto docs:
og:title/og:description/twitter:cardwere added todocs/.vitepress/config.tshead in v0.1.1 (Sept) — never appeared in any build; today's fix had to move all social meta intodocs/index.mdfrontmatter instead (PR seo(docs): keyword-rich title, description, OG/Twitter meta, canonical covecto#38) - uteke docs (codecora.dev/uteke/docs): same class — live HTML has
<title>Uteke</title>(7 chars), no og:/twitter: tags at all
Suggested fix
In createConfig():
head: [
...themeDefaults, // existing preconnect/font/theme-color/accent entries
...(opts.head ?? []),
],Extra notes
- Root-page
<title>equalsopts.titleverbatim (no suffix) while subpages use"<Page> | <site title>"— so products should pass a keyword-rich site title, or accept a bare one on the root page - No per-page canonical/og:url is emitted anywhere; only frontmatter
head:works today (VitePress frontmatterheadmerges reliably, values containing:must be YAML-quoted)
Activity
ajianaz commentedon Oct 5, 2026
Additional findings from the 2026-10-05 live vision audit (post-fix re-verification of codecora.dev/covecto/docs after PR codecoradev/covecto#40):
Install/GitHubpills render light-bg + light text (near-invisible). VitePress default.VPButton.altcolors don't adapt to the dark theme tokens. Theme should set alt-button text to a dark ink on light bg (or invert).#in rendered headings —## Engine Comparisonrenders with a visible#prefix (theme defaulth2::beforecontent). Should be removed in the shared theme.src: '/logo.png'which never resolves underbase: '/<product>/docs/'(workaround shipped per-repo viadocs/public/logo.png; proper fix ={base}logo.pngor theme-shipped asset).opts.headsilently dropped.All five are shared-theme defects affecting every product docs site (verified on covecto; uteke confirmed for logo + head at least).