Design the decision surface
The first viewport should answer four questions:
- Where am I?
- What matters now?
- What can I do next?
- What happened after I acted?
Reference handbook
A practical standard for mobile-first, enterprise-grade, accessible, resilient, and responsible web applications. The emphasis is not visual novelty. It is clear prioritization, trustworthy interaction, and complete product behavior.
01 · Definition
Mobile-first is a product architecture discipline. It begins with the most important outcome, the least available space, and the weakest credible operating condition.
The first viewport should answer four questions:
Content should remain understandable when columns stack, sidebars disappear, text wraps, images fail, or the page is zoomed.
Design for thumbs, variable dexterity, one-handed use, short sessions, interruptions, and no hover.
Account for slow devices, variable networks, battery limits, browser differences, stale data, and partial failure.
The mobile home screen should be a decision surface, not a miniature portal.
02 · Enterprise standard
Mature enterprise applications balance task completion, governance, accessibility, security, data density, scale, and maintainability.
| Priority | Purpose | Typical content |
|---|---|---|
| Immediate | Enable action now | Current status, urgent exceptions, primary action |
| Supporting | Enable a sound decision | Context, summary metrics, critical dependencies |
| Investigative | Enable diagnosis | History, details, logs, related records |
| Administrative | Enable configuration | Metadata, permissions, infrequent controls |
Responsive design changes dimensions. Adaptive design may change the composition.
Compact Expanded
────────────────── ─────────────────────────────
Top app bar Persistent top bar
Single content pane Navigation rail + content
Bottom navigation Side navigation
List view List-detail split view
Filter sheet Persistent filter panel
Overflow actions Visible contextual toolbar
Tokens, components, release controls, migration guides, and deprecation policy.
Performance budgets, observability, localization, role complexity, and extensibility.
Visible state, auditable actions, transparent data use, and predictable recovery.
03 · Discoverability
Extreme minimalism often removes the cues users need. Discoverability is the ability to see where to go, what is possible, and what will happen.
Use bottom navigation for three to five high-frequency destinations. Put account, settings, and infrequent destinations in a secondary menu.
Prefer one dominant action per decision point. Secondary actions should remain available but visually quieter. Destructive actions require separation and explicit wording.
04 · Accessibility
WCAG 2.2 Level AA should be the compliance baseline. Production quality usually requires more generous touch targets and broader assistive-technology validation.
| Mode | What to validate |
|---|---|
| Touch | Reach, target size, spacing, accidental activation, sticky controls |
| Keyboard | Order, focus visibility, traps, skip links, dialogs, menus |
| Screen reader | Names, roles, states, headings, live announcements, errors |
| Zoom / reflow | 200%+ zoom, text resize, no page-level horizontal scroll |
| Voice / switch | Visible labels, unique names, predictable activation |
| Reduced motion | No essential meaning depends on animation |
05 · Performance and resilience
A polished interface that responds slowly feels broken. The delivery sequence should favor comprehension and task readiness over visual completeness.
HTML
└── Meaning, content, navigation, forms, links
CSS
└── Layout, hierarchy, responsive adaptation, visual states
JavaScript
└── Filtering, live validation, optimistic updates,
richer data exploration, local persistence
Use real URLs, native form semantics, server-rendered results, and browser history. JavaScript should add capability rather than provide the only path to the core task.
06 · Enterprise data
Enterprise interfaces often contain tables, filters, dashboards, batch actions, and record detail. Each compact treatment should preserve the user’s actual task.
Use when users primarily scan, open, or act on individual records.
Use when cross-record comparison is essential.
Use separate screens on compact layouts and a split view on larger layouts.
Lead with current condition, exceptions, trend, and recommended action.
07 · Forms and recovery
Mobile forms should preserve user input, communicate consequences, and make recovery direct.
Idle → Submitting → Success
↘ Failed → Retry
↘ Pending → Success | Failed
Loading, saving, pending approval, stale, and offline are not interchangeable. Each state needs distinct language, timing, and recovery behavior.
08 · Responsible design
Responsible design includes accessibility, privacy, security, internationalization, transparent automation, and resistance to manipulative patterns.
09 · Best-in-class patterns
These patterns repeatedly produce strong task completion and communication when applied with the correct information hierarchy.
Short top bar, visible search when central, and three to five primary destinations on compact layouts.
Current condition → exceptions → trend → recommended action → supporting detail.
Visible scope, applied-filter summary, result count, deliberate apply action, persistent query state.
Separate screens on compact layouts, split panes on larger screens, preserved history throughout.
Use for secondary detail, advanced settings, and troubleshooting. Never hide critical warnings or required inputs.
Use label–value pairs for key facts, metadata, and review-before-submit workflows.
State what completed, reference number, date, next steps, expected timing, and support path.
Place the recovery action next to the failure. Preserve user work and explain system state.
10 · Production value
The strongest products feel complete because hierarchy, spacing, copy, states, motion, and component behavior reinforce one another.
Use typography, spacing, position, and contrast to express importance. Too many cards flatten the page.
Use a constrained spacing scale. Tight spacing should imply relationship. Large spacing should signal a new region.
Prioritize legible x-height, clear numerals, comfortable line height, and tabular figures for metrics.
Include focus, pressed, disabled, loading, error, success, read-only, empty, and long-content states.
Use motion to explain origin, change, continuity, or ongoing work. Do not delay comprehension.
Use verbs, state consequences, front-load meaning, and write errors in recovery language.
layout:
outer-gutter: 16px
content-columns: 1
page-horizontal-scroll: prohibited
interaction:
preferred-touch-target: 44-48px
primary-actions-per-decision: 1
major-navigation-destinations: 3-5
typography:
body-baseline: 16px
body-line-height: 1.45-1.6
delivery:
semantic-html-baseline: required
javascript: enhancement-first
deep-linking: required
history-state: preserved
offline-and-stale-state: explicit
accessibility:
target: WCAG 2.2 AA
keyboard: complete workflows
zoom-and-reflow: supported
focus: visible and unobscured
reduced-motion: supported
11 · Systems to study
No single design system is sufficient. The strongest enterprise approach combines patterns according to product context.
| System | Best lessons | Adapt carefully |
|---|---|---|
| GOV.UK | Transactional clarity, plain language, errors, confirmation, progressive enhancement | Its restrained identity is not a consumer-brand template |
| USWDS | Accessible public-service components and resilient implementation guidance | Federal visual conventions require contextual adaptation |
| IBM Carbon | Enterprise data, tables, structured lists, dense workflows, AI disclosure | Desktop density must be transformed for compact layouts |
| Microsoft Fluent | Adaptive layout, cross-platform behavior, command overflow | Rich command surfaces can overload novice users |
| GitHub Primer | Productivity, compact interaction, responsive layout, touch guidance | Assumes frequent and technically fluent users |
| Material Design 3 | Compact navigation, sheets, canonical adaptive layouts, touch ergonomics | Unmodified use can appear generic |
| Salesforce Lightning | Record workflows, CRM structures, enterprise action patterns | Some dense components need additional mobile optimization |
| Atlassian | Tokens, spacing, governance, cross-product cohesion | Many patterns assume established product familiarity |
12 · Review rubric
Score each category from 0 to 5. Weight the score according to the percentages below.
A beautiful application with poor task completion should fail the review.
13 · Launch checklist
Progress is stored locally in this browser. This checklist is an enhancement; all guidance remains available without JavaScript.
14 · Sources
These are the principal systems and standards used to derive the handbook. Links open in a new tab.