Boise Today project

Boise Today / Design system

Documentation v0.1 · Boise publication · Townwell platform

Design system contents

Components

Editorial headings

Identify a page or section with a clear headline and optional supporting context.

On this page

Purpose and placement

Identify a page or section with a clear headline and optional supporting context.

Anatomy

Anatomy
PartBehavior
Page headingArchive title and explanatory copy.
Section headingNamed editorial group with source rule styling.

Configuration and contract

Configuration and contract
Input or decisionImplementation
SectionHeadingtitle string.
StoryArchiveHeadingtitle and description; pair with archive content.
LevelChoose heading level from document hierarchy, not desired visual size.

States and feedback

  • Short section labels.
  • Multi-line page titles and supporting descriptions.

Usage rules

  • Use concrete labels such as Local Stories rather than vague discovery language.
  • Avoid repeating the same h1 inside a nested module.

Accessibility and verification

Check the heading outline and zoomed phone wrapping. A decorative separator should not become a separate announced element.

Source references

Source references
FileResponsibility
components/site-shell.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.

Section Heading · Component detail · Light · Desktop · 1920 × 214 px
Story Archive · Screen · Light · Desktop · 2880 × 2000 px

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