Summary
The homepage uses a custom Inkwell editorial theme (serif headlines, paper/ink tokens in assets/css/main.css). Docs pages switch to default Nuxt UI Pro dark styling. The transition feels like two different sites.
Location(s)
/ vs any docs route (e.g. /csharp/getting-started, /spec/draft-arcp-1.1)- All breakpoints
Severity
P2 — visual consistency / credibility at launch
Evidence
Screenshots:
.audit/evidence/audit-home-1280.png — light editorial hero, serif type, vermilion accent on paper tones.audit/evidence/audit-docs-1280-csharp-getting-started.png — dark Nuxt UI chrome, sans-serif prose defaults
Home uses layouts/default.vue (passthrough); docs use layouts/docs.vue with bg-(--ui-bg) and no shared Inkwell tokens.
Suggested fix
Apply Inkwell design tokens to docs layout (sidebar, prose, code blocks) or add a shared app shell so home → docs transition is cohesive. Consider aligning color mode (home respects system; docs default dark).
Acceptance criteria
Summary
The homepage uses a custom Inkwell editorial theme (serif headlines, paper/ink tokens in
assets/css/main.css). Docs pages switch to default Nuxt UI Pro dark styling. The transition feels like two different sites.Location(s)
/vs any docs route (e.g./csharp/getting-started,/spec/draft-arcp-1.1)Severity
P2 — visual consistency / credibility at launch
Evidence
Screenshots:
.audit/evidence/audit-home-1280.png— light editorial hero, serif type, vermilion accent on paper tones.audit/evidence/audit-docs-1280-csharp-getting-started.png— dark Nuxt UI chrome, sans-serif prose defaultsHome uses
layouts/default.vue(passthrough); docs uselayouts/docs.vuewithbg-(--ui-bg)and no shared Inkwell tokens.Suggested fix
Apply Inkwell design tokens to docs layout (sidebar, prose, code blocks) or add a shared app shell so home → docs transition is cohesive. Consider aligning color mode (home respects system; docs default dark).
Acceptance criteria
/to/specfeels like one product site