ux.sgit.ai

Findings / UX-046

Setting location.hash inside a vault app re-navigates the frame: every link silently dead

OpenHighFailuredev.vault.sgraph.ai

What we saw

In the host the app is an about:srcdoc frame, where assigning location.hash re-navigates instead of firing hashchange. The How Much Evidence vault shipped on 5 October 2026 with every view link dead.

Why it matters

An app that works when opened as a file ships to readers with no working navigation, and nothing errors.

The fix

Keep the route in a variable; catch a[href^="#"] in a capture click handler; mark links data-sg-native; use the hash only when running standalone. Documented in the sgit.ai guidance.

The record

StatusOpen. Open as a platform trap; every lab vault avoids it.
SeverityHigh
KindFailure: works against the reader
Productdev.vault.sgraph.ai, platform
Whereany vault app that routes by hash
ProblemsHost trap, Dead end
VisibilitySilent: no symptom on screen: found only by measuring, or by its consequences
RecommendationDesign for the host: use the host's own mechanisms (route variable, sg.state, vault snapshot) instead of the browser's defaults
AreaPlatform
BreaksA vault app works inside the host, not just on its own
Observed2026-10-05, host
Last checked2026-10-11, host
SourceDesign lab: what building it measured

Previous: UX-045 Persona pages are a list, with no story, opinion or next step

Next: UX-047 localStorage throws inside the vault app frame, so reader data is lost on reload