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
| Part | Behavior |
|---|---|
| Current image | Preview with source dimensions/aspect behavior. |
| Alternatives | Existing image choices where supplied. |
| Metadata | Alt text and contextual image values. |
| Upload feedback | Local preview, busy/error states. |
Configuration and contract
| Input or decision | Implementation |
|---|---|
| StoryThumbnailManager | storyId optional, imageUrl, alt, saveFormId, optional imageOptions and imageOptionsLoaded. |
| Persistence | Image 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
| File | Responsibility |
|---|---|
| components/admin/story-thumbnail-manager.tsx | Audited Townwell implementation; use this file when extending this interface. |
| components/admin/content-thumbnail-manager.tsx | Audited 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.
Related topics
Source audit: 2026-10-07 · Revision ce8bc72b96da · Documentation v0.1