Patterns
Reader subscription
Offer a clear publication email relationship with recoverable submission feedback.
On this page
Task and context
Offer a clear publication email relationship with recoverable submission feedback.
Flow and composition
| Stage | Interface responsibility |
|---|---|
| Invite | Explain what arrives in the inbox. |
| Enter | Email field and verification when configured. |
| Submit | Pending state prevents accidental duplicate operation. |
| Resolve | Confirmed provider success or actionable error. |
Decisions and handoff
- Respect source capability checks before showing signup.
- Keep consent/expectations adjacent to the form.
Recovery and acceptance
- Retain the entered address after failure.
- Do not claim delivery from an idle-state capture.
- No live subscription or email is sent while documenting the interface.
Source references
| File | Responsibility |
|---|---|
| components/newsletter-signup-form.tsx | Audited Townwell implementation; use this file when extending this interface. |
| lib/newsletter-landing.ts | 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