# Design and UX

## Mockups first
- One local HTML file, two or three options side by side at phone width, with a sentence each on the trade-off and your pick. Open it. Build only what's picked.
- Use realistic, made-up content in mockups, never real people's data.

## For tired thumbs
- Tap targets 44px or more. The most common action is the biggest button.
- Nothing important behind a tiny menu. Destructive actions: a visible button, then one confirm with the safe choice named ("Keep timing" / "Cancel feed").
- Sheets swipe down to close (over ~110px or a quick flick) and close on a tap outside.
- Undo in the toast after every save or delete. "Earlier?" chips to fix a time you logged late.
- Plain wording everywhere. Errors say what happened and what to do.

## Phone details
- Safe areas: `viewport-fit=cover` and `env(safe-area-inset-*)` padding; nothing under the clock or home bar.
- No sideways scroll on any page at 390px.
- Keep the screen awake (Wake Lock) only while a timer runs on that phone.
- Respect `prefers-reduced-motion` and `prefers-color-scheme`.

## Styling without surprises
- Give each new component a class prefix; generic names (`.note`, `.mini`, `.step`, `.ln`) clash with existing styles and break layouts.
- Line icons from one sprite; emoji only where they carry meaning.
- App icons are a small scene with meaning, not a flat letter. Render PNGs in a browser.
- Motion only where it shows something real happening (a timer, a sync, an upload), and short.

## Words
- Name things by what people do ("Log a past feed"), not how it's built.
- One action keeps the same name everywhere ("Put it live" → "It's live").
- Empty screens invite the first action.

## Accessibility (check, don't assume)
- Every control reachable and usable by keyboard, with a visible focus ring; a "Skip to content" link on content pages.
- Buttons and inputs have names (visible text or aria-label); icons alone get a label; images get alt text (empty alt if decorative).
- Text contrast at least 4.5:1 (3:1 for large text), measured in light and dark mode. Never rely on colour alone (add an icon or word).
- Headings in order, one h1 per page; landmarks (header, main, nav, footer).
- Respect prefers-reduced-motion: show the finished state instead of animating.
- Touch targets ~44px; text never below ~12px; works at 200% zoom and at 320px wide.
