Description
The Documentation Noob Tester (2026-06-22) found that clicking Search (Ctrl+K) on the docs site shows the dev-server message: "Search is only available in production builds. Try building and previewing the site to test it out locally." End users do not know what a production build is — they just see a broken search box, which is often the first thing newcomers reach for.
Expected Impact
Working (or gracefully hidden) search on the published docs site, removing a blocking first-impression friction point for new users.
Suggested Fix
Ensure the Astro/Starlight pagefind search index is generated and served on the production/published build, or hide the search affordance when the index is absent so the dev-only warning never reaches users.
Suggested Agent
A docs/site-build agent (Astro/Starlight).
Estimated Effort
Medium (1-2 hours)
Data Source
DeepReport 2026-06-22 — Documentation Noob Test Report 2026-06-22.
Generated by 🔬 DeepReport - Intelligence Gathering Agent · 215.7 AIC · ⌖ 18.6 AIC · ⊞ 10.5K · ◷
Description
The Documentation Noob Tester (2026-06-22) found that clicking Search (Ctrl+K) on the docs site shows the dev-server message: "Search is only available in production builds. Try building and previewing the site to test it out locally." End users do not know what a production build is — they just see a broken search box, which is often the first thing newcomers reach for.
Expected Impact
Working (or gracefully hidden) search on the published docs site, removing a blocking first-impression friction point for new users.
Suggested Fix
Ensure the Astro/Starlight pagefind search index is generated and served on the production/published build, or hide the search affordance when the index is absent so the dev-only warning never reaches users.
Suggested Agent
A docs/site-build agent (Astro/Starlight).
Estimated Effort
Medium (1-2 hours)
Data Source
DeepReport 2026-06-22 — Documentation Noob Test Report 2026-06-22.