clarity-firstlisted

# Clarity First — First-Time User Experience ## The Test Every screen, component, or flow must pass: 1. **Understand instantly?** — No reading, no thinking, no scanning. Obvious on sight. 2. **Need this?** — Does a first-time user need this element right now? 3. **Too much?** — Would removing half of this hurt the user? 4. **Simpler possible?** — Is there a version with fewer steps, words, or choices? If any answer is "no / yes / yes / yes" — redesign. ## Golden Rule > If a first-time user stops to think, the design is not finished. ## Default Choice When in doubt: **remove. simplify. reduce.** ## Audit Checklist Run per screen / component: - [ ] Value delivered in < 5 seconds of reading - [ ] No element requires prior app knowledge - [ ] Primary action is visually dominant, secondary is subdued - [ ] Copy uses plain language, zero jargon - [ ] Empty states guide — they don't confuse - [ ] Error messages say what to do, not just what went wrong - [ ] No more than one primary CTA per screen - [ ] Progressive disclosure: advanced options hidden until needed - [ ] Loading states set expectations (skeleton, progress, message) - [ ] First interaction is a win, not a form ## Principles | Principle | Application | |---|---| | No assumptions | User knows nothing about your domain | | Less is more | Each element must earn its place | | Show only what matters now | Hide future complexity | | Reduce clicks | Every extra click is friction | | Reduce thinking | Labels, icons,