Official Playbook
Product Design Standard•UI/UX Quality For Web Apps

UI/UX Non-Negotiables for Web Applications

A practical, battle-tested standard for building software that is appealing, intuitive, reliable, accessible, and competitive.

// Purpose & Scope

This document defines the product experience standards that guide discovery, design, implementation, testing, and release at Gran Jefe. It is mandatory reading for product managers, designers, frontend and backend engineers, QA teams, and founders building functional web applications.

The Central Principle: A world-class app helps people accomplish their goals easily, quickly, confidently, and with as little unnecessary effort as possible. Visual beauty matters, but it cannot compensate for confusing workflows, unreliable behavior, inaccessible controls, or loss of trust.
01. Clarity

Can users understand what it does?

Do people understand what the app does immediately upon arrival and know what action to take next?

02. Efficiency

Can they finish without friction?

Can users complete their primary jobs-to-be-done without repetitive clicks, confusing inputs, or pointless decisions?

03. Confidence

Do they trust what is happening?

Are fees, state changes, and transaction outcomes transparent before and after commitment?

04. Reliability

Does it hold up under failure?

Does the interface maintain state and provide clear recovery when network drops or backend data fails?

Part 1

The 12 Non-Negotiable Standards

Each standard defines the user problem to prevent, the required engineering behavior, and the acceptance test for code review:

01.Clear Purpose & Intuitive Navigation

Navigation

Pain point: Users cannot tell where to start, where they are, or where to find a feature.

Required standard: Give every screen a clear purpose. Organise navigation around users' goals, use familiar labels, show the active location, and make important destinations easy to find. Keep information architecture shallow.

Acceptance test: A first-time user can locate core features without a teammate explaining the interface.

02. Effortless Core Workflows

Workflow

Pain point: Simple tasks take too many clicks, ask for repeated information, or force irrelevant decisions.

Required standard: Map the main tasks from start to finish. Remove redundant steps, reuse known information, set sensible defaults, and reveal advanced options only when needed. Optimise frequent journeys first.

Acceptance test: Representative users complete the top 3 to 5 tasks without avoidable friction.

03. Meaningful System Feedback

Feedback

Pain point: A click produces no visible response, or users cannot tell whether work is pending, complete, or failed.

Required standard: Explicitly design the relevant idle, loading, success, error, empty, disabled, pending, and offline states. Use progress indicators when useful and make outcomes persistent when users navigate away.

Acceptance test: Users can tell what the system is doing and what happened after every important action.

04.Error Prevention & Recovery

Resilience

Pain point: Users make avoidable mistakes, lose input, or cannot recover from failures.

Required standard: Validate fields at useful moments, explain constraints, preserve valid input, and provide corrective guidance. Add confirmations for consequential actions; support undo or cancellation where practical. Never rely on generic error banners alone.

Acceptance test: A user can correct a common mistake and continue without restarting the workflow.

05. Strong Visual Hierarchy

Design

Pain point: Everything competes for attention, obscuring the screen's purpose and next action.

Required standard: Use consistent typography, spacing, contrast, alignment, grouping, and restrained colour to show importance. Make the primary action distinguishable and eliminate decorative clutter that competes with task completion.

Acceptance test: At a glance, a user can identify the page purpose, important information, and primary action.

06. Consistency Across the Product

Design System

Pain point: Controls look or behave differently between screens, forcing users to relearn patterns.

Required standard: Create a shared design system for colour and spacing tokens, typography, buttons, inputs, tables, dialogs, icons, alerts, focus states, and responsive behavior. Reuse components and document exceptions.

Acceptance test: Patterns behave consistently, and knowledge gained on one screen transfers seamlessly to others.

07. Responsive Design That Works

Mobile & Responsive

Pain point: Desktop layouts are merely compressed on smaller screens, causing horizontal overflow and un-tappable controls.

Required standard: Design for available space and input method. Reflow content, adapt navigation, keep key actions reachable, and make complex tables or dialogs usable on supported devices. Test on real viewport sizes, not just browser resize previews.

Acceptance test: Users can complete core tasks on supported phones, tablets, and desktop screen sizes.

08. Accessibility by Default (WCAG 2.2 AA)

Accessibility

Pain point: Low contrast, missing labels, keyboard traps, or inaccessible custom controls prevent users from operating the app.

Required standard: Use WCAG 2.2 Level AA as a practical baseline. Provide semantic HTML structure, meaningful labels, visible focus rings, keyboard-operable controls, sufficient contrast (4.5:1 minimum), understandable errors, and text alternatives. Never rely on colour alone.

Acceptance test: Core tasks work cleanly with keyboard navigation alone, enlarged text, and assistive technology.

09.Speed & Visual Stability (Core Web Vitals)

Performance

Pain point: The app is slow, content shifts unpredictably while loading, or becomes unresponsive during interactions.

Required standard: Optimise images, fonts, JavaScript, API payloads, and rendering. Target LCP ≤ 2.5s, INP ≤ 200ms, and CLS ≤ 0.1 at the 75th percentile. Use skeleton loaders or progress feedback where they help rather than disguise long waits.

Acceptance test: Performance is verified with real-user field data and critical interactions stay responsive under slow 3G throttles.

10.Clear Content, Microcopy & Forms

Microcopy

Pain point: Form labels, instructions, requirements, or consequences are vague or written in internal company jargon.

Required standard: Use plain language and descriptive action buttons ("Confirm Transfer of ₦25,000" instead of "OK"). Mark required fields clearly, ask only for essential data, associate errors with fields, and assign appropriate mobile virtual keyboard types (email, numeric, tel).

Acceptance test: Users understand what to enter, why it is required, and what will happen after clicking submit.

11.Trust, Privacy & User Control

Trust

Pain point: Users cannot tell whether financial data is safe, an action is reversible, or a displayed status is actually confirmed.

Required standard: Communicate transaction fees, terms, permissions, and status with complete honesty. Minimise sensitive data exposure (mask card PANs). For consequential actions, show the essential facts before commitment.

Acceptance test: Users can make informed decisions with zero surprise fees and verify the result of important actions.

12. Continuous Usability Testing

Testing

Pain point: The product works for the engineers who built it, but breaks down for unfamiliar end users.

Required standard: Test realistic tasks with representative users. Observe hesitation, wrong turns, errors, and drop-off points. Combine quantitative analytics with qualitative user feedback to diagnose friction causes.

Acceptance test: Major usability issues are recorded, prioritised, fixed, and retested against empirical evidence before and after launch.
Part 2

Experience Priorities by Product Category

Different application types demand distinct UX priorities. Benchmark against the job users are hiring your product to accomplish:

Product CategoryPrimary UX Priorities to Enforce
SaaS PlatformsFrictionless onboarding, intuitive navigation, role permissions, search, workflow efficiency, and robust settings.
Admin DashboardsData accuracy, dense data tables, rapid filtering, pagination, bulk actions, and comprehensive auditability.
Fintech & BankingCrystal-clear transaction states, transparent fees, biometric authorization, payment confirmation sheets, and instant failure recovery.
E-CommerceProduct discovery, accurate specifications, real-time inventory status, delivery fee transparency, and 1-click checkout.
HealthcareHIPAA privacy, accessible high-contrast forms, clear patient instructions, understandable test results, and safe recovery.
Education & LMSCourse discovery, learning milestone tracking, self-paced progress persistence, clear feedback, and continuity across sessions.
Consumer Web AppsImmediate first-time success, fluid responsive interaction, helpful personalization, and zero distracting UI clutter.
Part 3

Product Release Quality Gate

Every product or major feature shipped by Gran Jefe must pass these 5 verification pillars before deployment. A checked item means the team has verified it empirically:

Core Functionality

  • Every primary action works end-to-end with real application data.
  • Loading, empty, success, failure, disabled, and offline states are handled.
  • Forms validate cleanly and preserve input when validation errors occur.
  • Navigation, search, filters, sorting, and pagination work accurately.
  • Unsuccessful or duplicate clicks do not create misleading success records.

Design & Usability

  • The purpose and primary call-to-action on every screen are unmistakable.
  • Typography, spacing, colours, icons, and components follow a shared design system.
  • The most frequent tasks omit redundant steps or repetitive data entry.
  • Consequential actions feature confirmation modals and clear outcome notices.
  • Labels and microcopy use language the intended customer understands.

Responsive & Accessible

  • Tested on real mobile, tablet, laptop, and ultra-wide desktop viewports.
  • Keyboard navigation and visible focus rings operate across the entire journey.
  • Contrast ratios meet WCAG 2.2 AA (4.5:1 text, 3:1 graphical elements).
  • Dialogs, dropdowns, tables, and modals remain usable when zoomed to 200%.
  • Information is never communicated by colour alone.

Performance & Trust

  • Core Web Vitals meet targets: LCP ≤ 2.5s, INP ≤ 200ms, CLS ≤ 0.1.
  • The interface remains usable when network requests are throttled or fail.
  • Authentication and sensitive data handling have completed security review.
  • Displayed balances, prices, and status match the backend ledger exactly.
  • Privacy choices and pricing terms are explained before commitment.

Release Decision Rule

Do not treat the quality checklist as a substitute for judgement. Block deployment for defects that could cause data loss, unauthorised access, misleading payment outcomes, or inability to complete a core task.

Part 4 & 5

Practical Prioritization & Team Principles

PRIORITY 1

Make it Reliable

Fix broken flows, incorrect data, security/privacy risks, lost input, and misleading status.

PRIORITY 2

Make it Effortless

Streamline navigation, task steps, terminology, form fields, and eliminate friction points.

PRIORITY 3

Make it Fast & Inclusive

Tune rendering speeds, keyboard accessibility, contrast, and assistive tech support.

PRIORITY 4

Make it Distinctive

Refine brand identity, micro-interactions, motion curves, and power user shortcuts.

PRODUCT DESIGN PLAYBOOK / 02

The Premium UI Design Standard

Visual design non-negotiables for web products that feel polished, clear, credible, and distinctive. Built on three foundations: 01 Clarity, 02 Restraint, and 03 Consistency.

// The Guiding Rule

Premium does not mean more gradients, more shadows, more animation, or more cards. It means better judgement: fewer competing elements, stronger hierarchy, thoughtful spacing, refined details, and consistent execution.

01 / FOUNDATIONS

The Premium Visual Mindset

01. Clarity before decoration

The visual hierarchy must make the purpose of a page, its key information, and its primary action obvious in 3 to 5 seconds.

02. Restraint creates emphasis

When every element is loud, nothing is important. Use colour, weight, scale, borders, and motion selectively.

03. Consistency creates confidence

A repeated, reliable visual language feels deliberate. Repeated exceptions make a product feel assembled rather than designed.

04. Alignment signals craft

Edges, baselines, columns, icons, labels, and controls should line up with intention. Tiny misalignments are surprisingly visible.

05. Real content is the design

Long names, empty data, large numbers, errors, and dense tables must still look good. Never design only around ideal placeholder content.

06. Useful details beat visual tricks

A purposeful status badge, clear focus state, or well-written empty state is worth more than ornamental effects.

Visual Hierarchy LayersThe 4 Functional Planes
LayerWhat it communicatesTypical treatment
PrimaryThe main purpose or decision on the screenOne dominant heading or focal area; one clear primary action
SecondarySupporting information and useful next stepsSmaller type, lower emphasis, clearly grouped sections
TertiaryMetadata, helpers, timestamps, optional controlsMuted text, compact scale, restrained icons
StateSuccess, warning, error, pending, disabledSemantic colour plus explicit text or icon; never colour alone
02 / STRUCTURE & SCALE

Typography, Spacing, and Layout Tokens

Typography Hierarchy Tokens
Display / Hero40–56 px desktop; scale down responsively
Page title28–36 px desktop; 24–30 px compact
Section heading18–24 px (hierarchy, not boldness alone)
Body text14–16 px (comfortable reading size)
Labels & Helper12–14 px (never rely on tiny text for key facts)

Rules: Legibility over thinness. Sentence case standard. Controlled line lengths (narrow reading columns).

Spacing Rhythm & Compact Radii
4px Base Rhythm4, 8, 12, 16, 24, 32, 40, 48 px
Inside components8–16 px (grouped, not cramped)
Between sections24–40 px (clearly distinct)
Page gutters16–24 px mobile; 24–40 px desktop
Compact Radii Scale6, 10, 14, 20 px (+ pill for badges only)

Rules: Whitespace before drop shadows. Thin, low-contrast borders for crisp layout structure.

03 / STATES & BEHAVIOR

The Mandatory State Matrix

A component is not finished when its default state looks good. It is finished when all relevant interaction states look and work correctly.

StateWhat users should seeDesign direction
DefaultThe control or section is readyClear label, affordance, hierarchy
Hover / Focus / PressedThe interaction target is unmistakableVisible state change; keyboard focus must never depend on hover
Loading / PendingWork is happening in the backgroundProgress spinner/skeleton, disabled duplicate action, stable layout
Success / CompleteThe operation finished successfullySpecific confirmation and updated content/status
Empty / First UseThere is no content yetExplain why, show a helpful next step, avoid a blank dead end
Error / OfflineThe operation failed or cannot proceedPlain-language explanation, recovery option, preserve user work
Disabled / UnavailableThe action cannot currently be usedClear appearance and explain the reason when it is not self-evident
04 / ANTI-PATTERNS

8 Premium Traps to Actively Avoid

Avoid the shortcuts that make an interface look trendy on Dribbble but feel generic, noisy, or unfinished in production.

TrapWhy it weakens the productBetter standard
Gradient everywhereDestroys hierarchy and dates the visual languageReserve gradients for a specific brand moment or meaningful emphasis
Glassmorphism by defaultCan impair contrast and make content feel fragileUse translucent materials only when depth or context genuinely benefits
Cards for every elementCreates visual noise and unnecessary nested surfacesUse layout, spacing, and typography before adding a container
Excessive roundingMakes every component feel soft and indistinguishableDefine a small radius scale (6, 10, 14, 20px) and use roles consistently
Oversized hero layouts in toolsPushes useful information below the foldGive task-based products compact, clear working headers
Muted text everywhereLooks subtle but weakens readability and hierarchyUse muted tones only for genuinely secondary info and verify contrast
Decorative animationSlows tasks and competes for user attentionUse motion to explain a change or acknowledge an action (120–220ms)
Generic template appearanceLacks a recognisable product identityCreate a restrained brand language from typography, colour, imagery, and detail
05 / VERIFICATION

The Premium Design Release Gate

Visual hierarchy is obvious without explanation (passes 3–5s One-Screen Test).
Typography roles, spacing, colour, radii, and elevation are tokenised and consistent.
The interface uses whitespace intentionally and aligns to a predictable grid.
Primary actions are unmistakable (one per area); lower-priority actions are restrained.
Buttons, inputs, navigation, tables, and overlays have complete relevant states.
Colour combinations and focus states pass WCAG AA accessibility checks.
Mobile, tablet, laptop, and wide layouts have been inspected with realistic content.
Loading, empty, pending, success, disabled, and error views feel intentionally designed.
Animations are purposeful (120–220ms) and reduced-motion preferences are respected.
Screen has been reviewed for clutter, unnecessary decoration, and generic patterns.
// The Release Principle

If the interface is visually impressive but confusing, inaccessible, inconsistent, or slow, it is not premium. Fix the experience before adding more polish.

Learn How to Build Against These Standards

Our 9 curated curriculums in Frontend, Backend, Product Management, and Systems incorporate every rule from this quality playbook into hands-on checkmark projects.

Explore All Curriculums