Boise Today project

Boise Today / Design system

Documentation v0.1 · Boise publication · Townwell platform

Design system contents

Foundations

Typography

Editorial serif reading and operational sans-serif controls have different jobs.

On this page

Source families

Source families
RoleStackApplication
Public copykepler-std, Georgia, serifReading text and editorial voice.
Public displaykepler-std-display with serif fallbacksProminent editorial headings.
Public smallpacaembu-light, Arial, sans-serifSupporting interface text and metadata.
Admin copy/display/smallInter and system sans-serif fallbacksCompact forms, lists and publishing controls.
Admin monoSFMono-Regular and monospace fallbacksTechnical identifiers and code-like values.

Hierarchy and writing

  • Keep one page-level h1; use h2 for sections and h3 for list-item titles when nested below a section.
  • Use title size to express importance, not to compensate for overly long copy.
  • Test long story names in list rows and phone layouts; allow natural wrapping.
  • A short label belongs on a control. Longer explanation belongs in the field description or adjacent help.

Font delivery and fallback

The source root loads the vkk5agl Adobe Typekit stylesheet. A team must verify the intended families are actually available in the deployed environment; a CSS family declaration alone does not guarantee delivery. Captures wait for font readiness, but fallback behavior still needs a separate slow-network review.

Source references

Source references
FileResponsibility
app/layout.tsxAudited Townwell implementation; use this file when extending this interface.
app/globals.cssAudited Townwell implementation; use this file when extending this interface.
components/site-shell.tsxAudited Townwell implementation; use this file when extending this interface.
components/admin-ui.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.

Section Heading · Component detail · Light · Desktop · 1920 × 214 px
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