Context
Client-side navigation (the SPA layer) in bunpress has issues that need triage. This issue is the umbrella to enumerate and fix them.
Scope
Initial triage list (expand as bugs surface):
- Hard-reload vs SPA navigation: which links navigate via SPA, which fall through to full page reloads, and is that intentional?
- Scroll restoration on back/forward navigation
- Hash anchor links work on first nav AND subsequent SPA nav
- Active sidebar item updates on SPA nav (no stale highlight)
- Page transitions don't flash unstyled content
- Search → result click → SPA nav (no full reload)
- Theme toggle persists across SPA nav without flash
- Browser title and meta tags update on SPA nav
- 404 handling for client-side route misses
- Error boundary if a page chunk fails to load
Verification
- Manual click-through on a non-trivial bunpress site (the bunpress docs site itself, or stacks docs)
- Lighthouse SPA audit clean
- DevTools network panel shows no full-document fetches on internal nav