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.
Can users understand what it does?
Do people understand what the app does immediately upon arrival and know what action to take next?
Can they finish without friction?
Can users complete their primary jobs-to-be-done without repetitive clicks, confusing inputs, or pointless decisions?
Do they trust what is happening?
Are fees, state changes, and transaction outcomes transparent before and after commitment?
Does it hold up under failure?
Does the interface maintain state and provide clear recovery when network drops or backend data fails?
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
NavigationPain 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.
02. Effortless Core Workflows
WorkflowPain 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.
03. Meaningful System Feedback
FeedbackPain 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.
04.Error Prevention & Recovery
ResiliencePain 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.
05. Strong Visual Hierarchy
DesignPain 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.
06. Consistency Across the Product
Design SystemPain 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.
07. Responsive Design That Works
Mobile & ResponsivePain 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.
08. Accessibility by Default (WCAG 2.2 AA)
AccessibilityPain 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.
09.Speed & Visual Stability (Core Web Vitals)
PerformancePain 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.
10.Clear Content, Microcopy & Forms
MicrocopyPain 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).
11.Trust, Privacy & User Control
TrustPain 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.
12. Continuous Usability Testing
TestingPain 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.
Experience Priorities by Product Category
Different application types demand distinct UX priorities. Benchmark against the job users are hiring your product to accomplish:
| Product Category | Primary UX Priorities to Enforce |
|---|---|
| SaaS Platforms | Frictionless onboarding, intuitive navigation, role permissions, search, workflow efficiency, and robust settings. |
| Admin Dashboards | Data accuracy, dense data tables, rapid filtering, pagination, bulk actions, and comprehensive auditability. |
| Fintech & Banking | Crystal-clear transaction states, transparent fees, biometric authorization, payment confirmation sheets, and instant failure recovery. |
| E-Commerce | Product discovery, accurate specifications, real-time inventory status, delivery fee transparency, and 1-click checkout. |
| Healthcare | HIPAA privacy, accessible high-contrast forms, clear patient instructions, understandable test results, and safe recovery. |
| Education & LMS | Course discovery, learning milestone tracking, self-paced progress persistence, clear feedback, and continuity across sessions. |
| Consumer Web Apps | Immediate first-time success, fluid responsive interaction, helpful personalization, and zero distracting UI clutter. |
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.
Practical Prioritization & Team Principles
Make it Reliable
Fix broken flows, incorrect data, security/privacy risks, lost input, and misleading status.
Make it Effortless
Streamline navigation, task steps, terminology, form fields, and eliminate friction points.
Make it Fast & Inclusive
Tune rendering speeds, keyboard accessibility, contrast, and assistive tech support.
Make it Distinctive
Refine brand identity, micro-interactions, motion curves, and power user shortcuts.
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.
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.
The Premium Visual Mindset
The visual hierarchy must make the purpose of a page, its key information, and its primary action obvious in 3 to 5 seconds.
When every element is loud, nothing is important. Use colour, weight, scale, borders, and motion selectively.
A repeated, reliable visual language feels deliberate. Repeated exceptions make a product feel assembled rather than designed.
Edges, baselines, columns, icons, labels, and controls should line up with intention. Tiny misalignments are surprisingly visible.
Long names, empty data, large numbers, errors, and dense tables must still look good. Never design only around ideal placeholder content.
A purposeful status badge, clear focus state, or well-written empty state is worth more than ornamental effects.
| Layer | What it communicates | Typical treatment |
|---|---|---|
| Primary | The main purpose or decision on the screen | One dominant heading or focal area; one clear primary action |
| Secondary | Supporting information and useful next steps | Smaller type, lower emphasis, clearly grouped sections |
| Tertiary | Metadata, helpers, timestamps, optional controls | Muted text, compact scale, restrained icons |
| State | Success, warning, error, pending, disabled | Semantic colour plus explicit text or icon; never colour alone |
Typography, Spacing, and Layout Tokens
Rules: Legibility over thinness. Sentence case standard. Controlled line lengths (narrow reading columns).
Rules: Whitespace before drop shadows. Thin, low-contrast borders for crisp layout structure.
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.
| State | What users should see | Design direction |
|---|---|---|
| Default | The control or section is ready | Clear label, affordance, hierarchy |
| Hover / Focus / Pressed | The interaction target is unmistakable | Visible state change; keyboard focus must never depend on hover |
| Loading / Pending | Work is happening in the background | Progress spinner/skeleton, disabled duplicate action, stable layout |
| Success / Complete | The operation finished successfully | Specific confirmation and updated content/status |
| Empty / First Use | There is no content yet | Explain why, show a helpful next step, avoid a blank dead end |
| Error / Offline | The operation failed or cannot proceed | Plain-language explanation, recovery option, preserve user work |
| Disabled / Unavailable | The action cannot currently be used | Clear appearance and explain the reason when it is not self-evident |
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.
| Trap | Why it weakens the product | Better standard |
|---|---|---|
| Gradient everywhere | Destroys hierarchy and dates the visual language | Reserve gradients for a specific brand moment or meaningful emphasis |
| Glassmorphism by default | Can impair contrast and make content feel fragile | Use translucent materials only when depth or context genuinely benefits |
| Cards for every element | Creates visual noise and unnecessary nested surfaces | Use layout, spacing, and typography before adding a container |
| Excessive rounding | Makes every component feel soft and indistinguishable | Define a small radius scale (6, 10, 14, 20px) and use roles consistently |
| Oversized hero layouts in tools | Pushes useful information below the fold | Give task-based products compact, clear working headers |
| Muted text everywhere | Looks subtle but weakens readability and hierarchy | Use muted tones only for genuinely secondary info and verify contrast |
| Decorative animation | Slows tasks and competes for user attention | Use motion to explain a change or acknowledge an action (120–220ms) |
| Generic template appearance | Lacks a recognisable product identity | Create a restrained brand language from typography, colour, imagery, and detail |
The Premium Design Release Gate
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.

