# AI use cases for Uisight (sololabstr/uisight)

Repo: [sololabstr/uisight](https://github.com/sololabstr/uisight) | Use cases: 3 | Page: https://dedupedai.com/use-cases/sololabstr-uisight/

uisight is an MCP server and CLI that runs live mobile and desktop browser sessions of a web UI and reports measured findings such as contrast ratios, touch target sizes and theme drift as text an agent can act on.

This file holds every use case of this repo. Each one starts with a "## " heading and ends with its URL.

- Audit a site's contrast and tap targets on phone and desktop: https://dedupedai.com/use-cases/sololabstr-uisight/audit-site-contrast-and-touch-targets/
- Let your coding agent measure and fix UI bugs over MCP: https://dedupedai.com/use-cases/sololabstr-uisight/let-coding-agent-measure-and-fix-ui/
- Review a UI live with your agent side by side: https://dedupedai.com/use-cases/sololabstr-uisight/review-ui-live-with-agent-side-by-side/

## How to audit a site's contrast and tap targets on phone and desktop with Uisight

Repo: [sololabstr/uisight](https://github.com/sololabstr/uisight) | Difficulty: Beginner | Time: 15 minutes | Basis: From the README

Run a one-shot audit across iPhone, Pixel and desktop in light and dark themes and get measured findings.

**Who it is for:** A frontend developer shipping a landing page who wants to catch unreadable text and tiny buttons before launch.

**The problem:** Eyeballing screenshots cannot tell a passing contrast ratio from a failing one.

**The outcome:** PNGs, a gallery and a report listing failing contrast and touch targets with their selectors.

### Steps

1. Install the browser with `npx playwright install chromium`
2. Run `npx uisight https://yourapp.com --theme both`
3. Open the gallery and report
4. Fix each element by the selector listed

### Prompt to paste into your agent

```text
Run `npx uisight <url> --theme both` from sololabstr/uisight and list every contrast or touch target finding with its selector and device. Verify each listed selector exists in the page source.
```

### Caveat

It covers web and responsive UIs only, not native iOS or Android apps.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/sololabstr-uisight/audit-site-contrast-and-touch-targets/

## How to let your coding agent measure and fix UI bugs over MCP with Uisight

Repo: [sololabstr/uisight](https://github.com/sololabstr/uisight) | Difficulty: Intermediate | Time: 30 minutes | Basis: From the README

Add Uisight as an MCP server so the agent can inspect pages and fix the exact selector it reports.

**Who it is for:** A developer using Claude Code who is tired of pasting phone screenshots into chat.

**The problem:** Agents burn tokens squinting at screenshots and still guess wrong.

**The outcome:** The agent receives text findings with selectors and fixes the right element.

### Steps

1. Install Chromium with `npx playwright install chromium`
2. Add the server with `claude mcp add --scope user uisight -- npx -y -p uisight@latest uisight-mcp`
3. Ask the agent to inspect your local dev URL
4. Have it fix each finding and re-run inspect

### Prompt to paste into your agent

```text
With the uisight MCP server, inspect <local URL> on mobile and desktop, fix every contrast and touch target finding in the code, and re-run inspect. Confirm the finding count dropped to zero or explain any that remain.
```

### Caveat

Limiting tools with UISIGHT_TOOLS keeps the tool list small, which the README recommends for measuring sessions.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/sololabstr-uisight/let-coding-agent-measure-and-fix-ui/

## How to review a UI live with your agent side by side with Uisight

Repo: [sololabstr/uisight](https://github.com/sololabstr/uisight) | Difficulty: Intermediate | Time: 30 minutes | Basis: From the README

Open the shared panel showing mobile and desktop sessions of the same site, URL-synced, that you and the agent both see.

**Who it is for:** A solo founder iterating on a responsive layout with an AI agent.

**The problem:** You and the agent look at different screens and talk past each other.

**The outcome:** One live panel where you can pin a bug and the agent reads the note and frame.

### Steps

1. Install Chromium with `npx playwright install chromium`
2. Start your app on localhost
3. Run `npx -y -p uisight uisight-panel http://localhost:3000`
4. Browse, pin issues, and let the agent read them through MCP

### Prompt to paste into your agent

```text
Start `npx -y -p uisight uisight-panel <local URL>` from sololabstr/uisight, then read any pinned notes and fix them. Confirm each pinned issue is resolved on both mobile and desktop sessions.
```

### Caveat

Add the webkit browser if you need the real iOS Safari engine; Chromium alone emulates it.

Disclaimer: Third-party repos we don't own or vouch for. AI-generated use cases can be wrong: review everything and run at your own risk. Full text: https://dedupedai.com/disclaimer/

URL: https://dedupedai.com/use-cases/sololabstr-uisight/review-ui-live-with-agent-side-by-side/