Boise Today project

Boise Today / Design system

Documentation v0.1 · Boise publication · Townwell platform

Design system contents

Patterns

Editorial discovery

Help a reader move from the homepage to a relevant local story without losing context.

On this page

Task and context

Help a reader move from the homepage to a relevant local story without losing context.

Flow and composition

Flow and composition
StageInterface responsibility
OrientBoise masthead and named sections.
ScanLead story, supporting compact items and local topic context.
BrowseArchive heading, standard list items and addressable pagination.
ReadArticle with origin, image and body hierarchy.

Decisions and handoff

  • Use standard items for primary lists and compact items for supporting rails.
  • Preserve the article topic and canonical destination across homepage, search and archive.

Recovery and acceptance

  • No imagery uses an intentional fallback, not a stretched placeholder.
  • Missing editorial data must not imply fabricated current news.
  • Check back navigation returns to the expected archive context.

Source references

Source references
FileResponsibility
components/site-shell.tsxAudited Townwell implementation; use this file when extending this interface.
components/public-content-list-item.tsxAudited Townwell implementation; use this file when extending this interface.
components/story-archive-list.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.

Homepage · Screen · Light · Desktop · 2880 × 2000 px
Story Archive · Screen · Light · Desktop · 2880 × 2000 px
Story Detail · Screen · Light · Desktop · 2880 × 2000 px
Story Detail · Screen · Light · Desktop · Full Page · 2880 × 4796 px

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