Context
The default bunpress theme has accumulated styling issues that hurt the perceived quality of any docs site built on it. This issue tracks a styling pass on the default theme.
Scope
The exact list will be filled out as we audit, but starting points:
- Audit code block rendering (syntax highlighting consistency, padding, copy button hover state, language label)
- Sidebar nav: active state, nested item indentation, mobile drawer behaviour
- Header: search, theme toggle alignment, mobile collapse
- Typography: prose width on wide screens, heading anchor link styles, blockquote treatment
- Tables: borders, zebra striping, mobile overflow handling
- Custom containers (tip/warning/danger/info): visual consistency, dark mode contrast
- Footer: edit-on-github link styling, prev/next page nav
- Dark mode: full contrast pass, especially code blocks and admonitions
Out of scope
- SPA navigation issues (separate issue)
Reference
Compare against VitePress's polish baseline — bunpress's positioning is "VitePress for Bun," so the bar is set.