explaingit

dattamks/ui-ux-visual-evaluator

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

An automated tool that audits a website's visual design, accessibility, responsiveness, and interactions, producing one combined report with real measured evidence.

Mindmap

mindmap
  root((repo))
    What it does
      Scans live URLs or screenshots
      Checks accessibility with axe-core
      Clicks every interactive element
    Tech stack
      Python
      axe-core
      Chromium
      MCP server
    Use cases
      Audit site accessibility
      Compare design versions
      Catch broken buttons and links
    Audience
      Developers
      Designers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Audit a live website for real accessibility violations before shipping a redesign.

USE CASE 2

Compare two versions of a site or a competitor's site to spot design and usability regressions.

USE CASE 3

Run an automated sweep that clicks every button and link to find broken interactions.

What is it built with?

Pythonaxe-coreChromiumMCP

How does it compare?

dattamks/ui-ux-visual-evaluator0xhassaan/nn-from-scratch3ks/embedoc
Stars00
LanguagePythonPythonPython
Last pushed2023-06-08
MaintenanceDormant
Setup difficultymoderatemoderatehard
Complexity3/54/51/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs Python 3.9+ and a headless browser environment, localhost/VPN apps require running it locally.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

This tool checks a website or app's design and usability automatically and produces one combined report covering visual design, ease of use, accessibility, how well it adapts to different screen sizes, and whether buttons and links actually work. It can look at a live website address or at uploaded screenshots, and it can compare two versions of a site against each other, or compare your site against a competitor's. What makes it different from a tool that just gives opinions is that it runs real automated checks behind the scenes. It injects a well known accessibility scanner called axe-core directly into the page to find actual violations of accepted accessibility standards, complete with the specific rule broken and where on the page it happened. It also measures things like how many different fonts, colors, and shapes are used across a design, which can reveal inconsistency, and it captures core web performance numbers like how fast the page first shows content and how much it visually shifts while loading. Beyond the automated measurements, the tool can also click through every clickable element on a page to check whether links and buttons actually work, reporting back which ones are broken, throw errors, or do nothing at all, complete with before and after screenshots. By default this clicking is safe and will not submit forms or delete anything unless you specifically allow it. On top of all these measured checks, the tool can optionally bring in an AI agent to add subjective judgment about usability and visual taste, reading the same evidence a human reviewer would. You can use it three ways: as a command line tool you run directly, as an MCP server that lets AI assistants call it directly, or as a packaged skill for Claude. Running it requires Python and an environment able to launch a real browser in the background, since that is how it captures live pages. It only reaches public web addresses unless you run it on the same network as a private site. Everything runs locally, so screenshots and findings stay on your machine unless you choose to share the report, and the project is released under the MIT license.

Copy-paste prompts

Prompt 1
Help me run uiux-eval against my staging site and set CI thresholds in a .uiux.yml file.
Prompt 2
Show me how to use this tool's MCP server so my AI assistant can evaluate a URL directly.
Prompt 3
Explain the difference between this tool's headless scoring and its agent-judgment assessment mode.
Prompt 4
Walk me through comparing two versions of my site with uiux-eval compare and reading the diff report.

Frequently asked questions

What is ui-ux-visual-evaluator?

An automated tool that audits a website's visual design, accessibility, responsiveness, and interactions, producing one combined report with real measured evidence.

What language is ui-ux-visual-evaluator written in?

Mainly Python. The stack also includes Python, axe-core, Chromium.

What license does ui-ux-visual-evaluator use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is ui-ux-visual-evaluator to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is ui-ux-visual-evaluator for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.