Boise Today project

Boise Today / Design system

Documentation v0.1 · Boise publication · Townwell platform

Design system contents

Components

Story thumbnails

Select and describe story media while preserving provenance and correct image geometry.

On this page

Purpose and placement

Select and describe story media while preserving provenance and correct image geometry.

Anatomy

Anatomy
PartBehavior
Current imagePreview with source dimensions/aspect behavior.
AlternativesExisting image choices where supplied.
MetadataAlt text and contextual image values.
Upload feedbackLocal preview, busy/error states.

Configuration and contract

Configuration and contract
Input or decisionImplementation
StoryThumbnailManagerstoryId optional, imageUrl, alt, saveFormId, optional imageOptions and imageOptionsLoaded.
PersistenceImage selection belongs to the story/media workflow; source provider upload is excluded from capture.

States and feedback

  • Current image from existing Boise imagery.
  • No image, option loading and upload error need integration-specific checks.

Usage rules

  • Do not stretch images or use a tiny asset enlarged beyond its useful resolution.
  • Choose an alt description appropriate to this article rather than repeating a filename.
  • Keep attribution distinct from alternative text.

Accessibility and verification

Check file input names, preview description, selection controls and upload announcements. Capture review must confirm images finish loading before crops are taken.

Source references

Source references
FileResponsibility
components/admin/story-thumbnail-manager.tsxAudited Townwell implementation; use this file when extending this interface.
components/admin/content-thumbnail-manager.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.

Thumbnail · Component detail · Light · Desktop · 1920 × 1146 px
Story Editor · Screen · Light · Desktop · 2880 × 2000 px
Story Editor · Screen · Light · Desktop · Content · 2880 × 2000 px
Story Editor · Screen · Light · Desktop · Content Full Page · 2880 × 3858 px
Story Editor · Screen · Light · Desktop · Publishing · 2880 × 2000 px
Story Editor · Screen · Light · Desktop · Publishing Full Page · 2880 × 2844 px
Story Editor · Screen · Light · Desktop · Notes · 2880 × 2000 px
Story Editor · Screen · Light · Desktop · Notes Full Page · 2880 × 2770 px

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