UI Design Workbench

Русская версия · Changelog

Turn repository UI source into an offline interactive HTML workbench—without building or running the application.

UI source → cached UI map → strict UI IR → interactive HTML

Use it to understand unfamiliar UI, inspect screens and navigation, verify a reconstruction, or run an explicit UI/UX review.

Install

Requires Python 3.10+ and pipx.

pipx install ui-design-workbench-cli
uidw install-skill codex

install-skill also supports claude, cursor, gemini, copilot, opencode, agents, and all.

Optional local MCP support:

pipx inject ui-design-workbench-cli "mcp>=2,<3"

Verify the installation:

uidw --version
uidw doctor

Quick start

Choose preview detail once:

uidw --repo <repo> config setup

Build and open the source-derived workbench:

uidw --repo <repo> workbench --output-dir <artifacts> --level full --open

Run a UI/UX audit only when product critique is wanted:

uidw --repo <repo> review --output-dir <review-dir> --level full

workbench and check validate the projection. Only review creates UI/UX findings.

What it provides

• Screen, route, component, token, theme, and state inventory.
• Standalone HTML with source links and reconstructed navigation.
• Incremental scans that reprocess only changed UI files.
• Property-level evidence and explicit unsupported gaps instead of guessed UI.
• Sparse review patches and a separate, authorized source-apply step.
• Runtime-free Android, Apple, and Flutter source projection with deterministic geometry for the supported subset; native evidence is required only before claiming visual or pixel parity and is never launched automatically.

Supported source families include Web, React, Vue, Svelte, Jetpack Compose, Android Views XML, SwiftUI, Storyboard/XIB, WinUI/WPF, and Flutter.

Main commands

Run uidw help overview, uidw help advanced, or uidw <command> --help for details.

Accuracy and safety

• HTML is a deterministic runtime-free source projection for the supported shared layout subset, not proof of runtime or pixel parity.
• Android, Apple, and Flutter translation uses deterministic projection geometry for the supported shared layout subset; without separate native evidence it remains a structural projection, not proof of runtime or pixel parity.
• Unsupported bindings, custom drawing, runtime data, and platform behavior remain explicit gaps.
• Preview and review keep application source read-only; applying a proposal is a separate step.
• Derived cache and review state live outside the target repository by default.

Upgrade

pipx upgrade ui-design-workbench-cli
uidw install-skill codex

A Windows .exe is not published yet. PyPI + pipx is the primary cross-platform installation path.

Documentation

• Changelog
• Agent integrations
• Fidelity contract
• Native rendering
• Cache protocol
• Platform component catalog
• IR schema
• Review workflow

Current CLI version: 0.6.6.