PR #267 · pramaan-io/pramaan-app · merged 2026-06-08
Your help center is a folder, not a finder.
Without tags and a search index, readers give up before they read.
Each keystroke is a network roundtrip. The Help page becomes slower than the work it explains.
The fix — Build the catalog at build time, flip it in the browser — no server call per keystroke.
sequenceDiagram autonumber participant mdx as KB articles (MDX) participant build as Build pipeline participant index as Search index (JSON) participant browser as Browser (runtime) mdx->>build: frontmatter + title read build->>index: lean FlexSearch JSON emitted index->>browser: bundled with the Help page browser->>browser: live FlexSearch query — no server call browser->>browser: empty / no-results / results state
Agent guide for KB authors — now documents the optional frontmatter fields (audience, updated) that the build-time search index and tag system read from each article.
audience : Everyoneupdated : Jun 2026