Boise Today project

Boise Today / Design system

Documentation v0.1 · Boise publication · Townwell platform

Design system contents

Components

Fields, selects and textareas

Make editorial inputs understandable before entry and recoverable after errors.

On this page

Purpose and placement

Make editorial inputs understandable before entry and recoverable after errors.

Anatomy

Anatomy
PartBehavior
AdminFieldWrapping label, optional description and child control.
Input/selectNative input or select with source border, background and focus style.
TextareaMulti-line copy entry with deliberate row count.

Configuration and contract

Configuration and contract
Input or decisionImplementation
AdminFieldlabel, description and children.
Native propsname, defaultValue/value, required, disabled, readOnly and input type remain caller responsibilities.
ValidationThe primitive does not supply a domain validation/error association framework.

States and feedback

  • Editable input/select/textarea, read-only and disabled captures.
  • Focused input capture shows native focus styling.
  • Invalid and server errors require an explicit caller contract.

Usage rules

  • Use a visible label; placeholders cannot replace it.
  • Use descriptions for editorial guidance, not field names.
  • Keep invalid values so editors can correct them.
  • Choose disabled for unavailable editing and readOnly for inspectable values; they behave differently during form submission.

Accessibility and verification

The wrapped label helps name the input, but descriptions and errors need programmatic association where relevant. Review required, invalid and busy semantics rather than inferring them from color.

Composition example

<AdminField label="Story title" description="Keep the local context clear.">
  <AdminInput name="title" defaultValue={story.title} required />
</AdminField>

Source references

Source references
FileResponsibility
components/admin-ui.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.

Admin Fields · Component detail · Light · Desktop · 1920 × 1218 px
Admin Fields · Component detail · Light · Desktop · Focus · 1920 × 1218 px

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