UI/UX Suite
- Plugin
- Skill
- MCP server
- CLI
Design bugs by line number, each with the exact fix.
Exact line to fix
46 located findings on the test app, each with a file and a line.
WCAG rule cited
Checked against the Web Content Accessibility Guidelines (WCAG) 2.2.
Fix value given
Each finding shows the measured value and the exact change to make.
Works with: Any MCP (Model Context Protocol) client and any agent that reads skills. Tested: Claude Code, Cursor, Codex, Gemini CLI, OpenCode. Not tied to one model: the audit is plain code.
Try it with no install: npx ui-ux-suite . in your project.
Pick your agent
npx skills add Aboudjem/ui-ux-suite -gWorks in more than 70 agents: pick yours in the menu. Supported agents (new tab)Installs for all your projects. Only this project: drop -g.This installs the skills only. The MCP server is one more line: pick your agent.Its page on skills.sh (new tab)
Limit: The audit reads source code, not pixels.
github.com/Aboudjem/ui-ux-suite (new tab)Version 0.7.3
What it does
- Know exactly what to change. Each located finding has a file, a line, a value and a fix.
- Fix for the right reason. Each finding cites the Web Content Accessibility Guidelines (WCAG) rule or the design law behind it.
- See it work first. The broken test project gives 46 located findings.
- Keep your code safe. It reads your source and never edits it.
- Stop regressions.
--fail-underfails the build when the score drops.
How it works
- 1. Point it at a project folder. There is no config file and no setup step.
- 2. Read the ranked list of findings and the score.
- 3. Apply each fix yourself: the tool prints it and changes none of your source files.
- 4. Add it to your automated checks with a score bar or a baseline file.
Example
One finding from the README. It comes from a broken test project that ships in the repository.
$ npx ui-ux-suite test/fixtures/planted-ux-problems
- Where: src/styles.css:14 · selector .hero-subtitle
- Measured: 1.03:1 (APCA Lc 0) (needs 4.5:1)
- Why: Text #fbfbfb on #ffffff measures 1.03:1 (APCA Lc 0).
WCAG 2.2 §1.4.3 requires ≥ 4.5:1 for normal text.
- Fix: Change color on .hero-subtitle from #fbfbfb to #767676
(meets 4.5:1 on #ffffff), or darken further.
- Cites: WCAG 1.4.3 Contrast (Minimum) (AA)More ways to install
Claude Code plugin
claude plugin marketplace add Aboudjem/10xclaude plugin install ui-ux-suite@10xAgent skill, for Cursor, Codex and other agents
npx skills add Aboudjem/ui-ux-suiteMCP (Model Context Protocol) server
claude mcp add ui-ux-suite -- npx -y ui-ux-suite --mcpCommand line, with no install step
npx ui-ux-suite .As a dev dependency
npm install -D ui-ux-suiteLimits
- It reads source, not pixels. A high score is not proof of WCAG conformance.
- Some findings cover the whole project, such as too many fonts. They have no single line.
- Deep mode checks the running app. It is optional and needs two extra packages.
- It writes only the report and baseline files you ask for.
- Good for
- A measured design and accessibility check on a web project, in chat or in automated checks.
- Not for
- Fixing the code for you: it prints the change and you apply it.
Questions
What is UI/UX Suite?
UI/UX Suite is an open-source design audit tool. It works like a linter for design: each located finding has a file, a line, a measured value and a fix.
Which agents does UI/UX Suite work with?
Tested on 17 November 2026: Claude Code, Cursor, Codex, Gemini CLI and OpenCode. The MCP server works in any MCP client, and the command line needs no agent.
Does UI/UX Suite change my code?
No, it never modifies a source file in the project you point it at. A fix is printed for you to apply.
Is UI/UX Suite free?
Yes, it is open source under the MIT license. It needs no API key, and npm view ui-ux-suite dependencies prints nothing.