Boise Today project

Boise Today / Design system

Documentation v0.1 · Boise publication · Townwell platform

Design system contents

Components

Rich story editor

Author structured editorial body content while keeping formatting separate from metadata and publication.

On this page

Purpose and placement

Author structured editorial body content while keeping formatting separate from metadata and publication.

Anatomy

Anatomy
PartBehavior
Editable surfaceLexical editor labeled Story body.
ToolbarFormatting and insertion controls.
Hidden form valueSerializes the body for the containing editor form.

Configuration and contract

Configuration and contract
Input or decisionImplementation
StoryBodyEditorname, initialHtml and optional placeholder.
Node modelHeading, quote, lists, links and custom image content.
ErrorsSource onError throws; recovery and boundaries must be reviewed by the host.

States and feedback

  • Loaded structured body in both themes.
  • Active formatting, inserted media and embeds are source-defined features awaiting behavioral coverage.

Usage rules

  • Use real headings and lists rather than visual approximations.
  • Keep source, disclosure and correction information in their appropriate editor fields.
  • Validate content serialization and sanitization before rendering user-authored HTML publicly.

Accessibility and verification

Check toolbar names, keyboard operation, editable labeling, selection behavior and image alternatives. Static crops show appearance, not complete assistive-technology support.

Source references

Source references
FileResponsibility
components/admin/story-body-editor.tsxAudited Townwell implementation; use this file when extending this interface.
components/editor-toolbar-button.tsxAudited Townwell implementation; use this file when extending this interface.
components/admin/story-editor-form.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.

Rich Editor · Component detail · Light · Desktop · 1920 × 1214 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