Boise Today project

Boise Today / Design system

Documentation v0.1 · Boise publication · Townwell platform

Design system contents

Components

Search results

Show understandable destinations and reveal additional results without changing the meaning of the query.

On this page

Purpose and placement

Show understandable destinations and reveal additional results without changing the meaning of the query.

Anatomy

Anatomy
PartBehavior
Query contextGET query on the public search route.
ResultType/id identity, title, URL and contextual metadata.
Reveal actionAdds a local batch of supplied results.

Configuration and contract

Configuration and contract
Input or decisionImplementation
SearchResultsListresults array; initialCount defaults to 24; batchSize defaults to 24.
IdentityResult keys combine type and id.
Data boundarySearch service supplies results; the component does not define search ranking.

States and feedback

  • Results available.
  • No results with explicit empty feedback.
  • Additional-results control while undisplayed results remain.

Usage rules

  • Keep the submitted query in the interface.
  • Do not call local result reveal a new server search.
  • Use type metadata when a mixed result set contains similar titles.

Accessibility and verification

Check a labeled search input, clear submit action and predictable focus after reveal. Added results and count changes may need announcements; do not assume they exist from a static capture.

Source references

Source references
FileResponsibility
components/search-results-list.tsxAudited Townwell implementation; use this file when extending this interface.
app/(public)/search/page.tsxAudited Townwell implementation; use this file when extending this interface.
components/search-page-focus.tsxAudited 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.

Search Results · Component detail · Light · Desktop · 1920 × 932 px
Public Search · Screen · Light · Desktop · 2880 × 2000 px

Related topics

Source audit: 2026-10-07 · Revision ce8bc72b96da · Documentation v0.1