Patterns
Local search and result reveal
Connect a reader query to understandable story and place destinations.
On this page
Task and context
Connect a reader query to understandable story and place destinations.
Flow and composition
| Stage | Interface responsibility |
|---|---|
| Enter | Named search field and GET query. |
| Resolve | Query-aware results or no-results feedback. |
| Reveal | Show another local batch if supplied results remain. |
| Navigate | Use a real destination link with recognizable result type. |
Decisions and handoff
- Preserve query text across submit and back navigation.
- Do not confuse local client reveal with fetching/ranking a fresh result set.
Recovery and acceptance
- An unavailable search service needs different feedback from no matches.
- Check keyboard focus and announcement after result reveal.
- Fixture results are a fixed sample; search relevance is not certified.
Source references
| File | Responsibility |
|---|---|
| components/search-results-list.tsx | Audited Townwell implementation; use this file when extending this interface. |
| app/(public)/search/page.tsx | Audited Townwell implementation; use this file when extending this interface. |
Examples from the app
Actual Boise Today and Townwell UI with synthetic editorial, business, review, media metadata and analytics. Existing Boise imagery; no live data changes. Captured at 2× resolution or higher. Select an image to inspect it full size.
Related topics
Source audit: 2026-10-07 · Revision ce8bc72b96da · Documentation v0.1