Boise Today project

Boise Today / Design system

Documentation v0.1 · Boise publication · Townwell platform

Design system contents

Accessibility and content

Editorial clarity and alternatives

Make publication content understandable, attributable and usable when visual context is missing.

On this page

Content standards

Content standards
ContentRule
HeadlinesState the actual local subject; avoid invented urgency or unsupported claims.
Alt textDescribe the meaningful image information in context; filenames and credits are not alternatives.
CreditsPreserve photographer/source attribution separately from alt text.
Disclosure/correctionUse the dedicated editorial fields and keep the resulting reader context visible.
StatusDraft, published, scheduled, featured and review state each mean different things.
ErrorsExplain the operation that failed and what the person can do next.
Analytics/place dataLabel range, freshness and uncertainty; never turn sample values into actual outcomes.

Review procedure

  • Inspect the heading outline and link purpose without surrounding imagery.
  • Review long names and missing metadata on phone.
  • Check canonical URLs and date/time interpretation.
  • Keep private contacts and account records out of public screenshots.

Source references

Source references
FileResponsibility
lib/story-editorial.tsAudited Townwell implementation; use this file when extending this interface.
components/admin/story-editor-form.tsxAudited Townwell implementation; use this file when extending this interface.
lib/media-library.tsAudited 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.

Story Detail · Screen · Light · Desktop · 2880 × 2000 px
Story Detail · Screen · Light · Desktop · Full Page · 2880 × 4796 px
Thumbnail · Component detail · Light · Desktop · 1920 × 1146 px

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