AI-generated UI quality checklist

A review checklist for hierarchy, interaction, accessibility, responsive behavior, and visual consistency.

Better Design

Part of AI presentation maker

Direct answer

Review the screen's purpose first, its component system second, then its accessibility and responsive behavior in the browser.

A hand-drawn interface surrounded by checks for purpose, visual consistency, accessibility, responsive layouts, and browser evidence.

Before implementation

  • Name the user and the one task the screen must support.
  • Choose the design system or extract the existing one.
  • Identify the reusable components before creating new primitives.
  • Write the primary action as a specific verb and outcome.

During implementation

  • Use semantic tokens instead of page-specific colors and radii.
  • Keep heading levels and action hierarchy clear.
  • Use real buttons, links, labels, and form controls.
  • Handle loading, empty, error, disabled, and success states that the flow can reach.
  • Preserve the project's existing data and navigation behavior.

Rendered review

  • Check text contrast and non-text contrast against WCAG requirements.
  • Navigate the full task with a keyboard and confirm visible focus.
  • Test the narrowest supported viewport for clipping and horizontal overflow.
  • Open every changed menu, dialog, popover, and validation state.
  • Respect reduced-motion preferences and avoid motion that blocks the task.
  • Read the copy aloud and remove labels or explanations that repeat the same point.

The AI UI quality loop

Review purpose, system use, product states, accessibility, responsive behavior, and rendered evidence as one connected loop.

A hand-drawn quality loop connecting purpose, system, states, access, responsive behavior, and evidence.
  1. Purpose: Confirm the user, screen job, and primary action are obvious.
  2. System: Check that approved tokens and components carry the interface.
  3. States: Open loading, empty, error, disabled, and success states.
  4. Access: Verify semantics, contrast, keyboard flow, and visible focus.
  5. Responsive: Test the supported widths for clipping and task failure.
  6. Evidence: Capture and compare the rendered states that changed.

What automated checks cannot prove

TypeScript, lint, and automated accessibility tests catch important failures, but they cannot prove that hierarchy is obvious, spacing feels coherent, copy is understandable, or an overlay looks correct over real content.

Treat the browser review as part of implementation. Capture the states that changed and compare them with the original screen job before reporting completion.

Questions

What is the first thing to check in AI-generated UI?

Check whether a first-time user can identify the screen's purpose and primary action without an explanation. If not, fix the hierarchy before polishing details.

Are automated accessibility tests enough?

No. They are necessary but incomplete. Keyboard flow, focus order, meaningful labels, responsive behavior, and visual clarity still need hands-on review.

Should every generated screen introduce new components?

No. New components are justified when existing primitives cannot express the needed behavior cleanly. Reusing the current system usually produces a more coherent product and a smaller diff.

Sources