Boise Today project

Boise Today / Design system

Documentation v0.1 · Boise publication · Townwell platform

Design system contents

Components

Saved content

Let an authenticated reader save an item to a named list while keeping authentication and persistence explicit.

On this page

Purpose and placement

Let an authenticated reader save an item to a named list while keeping authentication and persistence explicit.

Anatomy

Anatomy
PartBehavior
TriggerSave action with expanded-state context.
List choicesExisting lists and new-list entry.
AuthenticationLogin-required path for visitors.
FeedbackRequest errors and saved state.

Configuration and contract

Configuration and contract
Input or decisionImplementation
IdentityUse the source supported content identity rather than a title as the persistent key.
PersistenceLists and membership are API-backed; client selection is not sufficient evidence of saved data.

States and feedback

  • Unauthenticated reader, authenticated lists, create-list flow and error recovery.
  • Capture APIs report the visitor state; no private account or saved collection is captured.

Usage rules

  • Keep the item context visible when requesting login.
  • Avoid optimistic confirmation without a successful persistence contract.

Accessibility and verification

Source uses aria-expanded for the trigger. Verify dialog focus, keyboard list selection and error announcements before extending this flow.

Source references

Source references
FileResponsibility
components/save-this-control.tsxAudited Townwell implementation; use this file when extending this interface.
components/save-this-button.tsxAudited Townwell implementation; use this file when extending this interface.
components/account/account-login-modal.tsxAudited Townwell implementation; use this file when extending this interface.

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