Automated UI/UX Testing

Test websites with intelligent browser automation and LLM-powered analysis

Get Started

GitHub

Intelligent Test Planning

Generates context-aware test plans by analyzing page structure and content

Real Browser Automation

Executes tests using Playwright with actual clicks, form inputs, and navigation

Multi-Viewport Testing

Tests desktop, tablet, and mobile viewports automatically with configurable sizes

Visual Documentation

Captures screenshots before and after each action for debugging and evidence

Concurrent Execution

Tests multiple pages in parallel with configurable browser pool (1-10 instances)

Comprehensive Reporting

Scored reports with categorized issues, reproduction steps, and fix recommendations

Quick Start

bash

npx @usharma124/ui-qa https://example.com

Prerequisites

An OpenRouter API key is required. See Configuration for setup details.

How It Works

UI QA processes websites through four phases:

Phase	Description
Discovery	Identifies pages via sitemap or link crawling
Planning	Generates test plans using LLM analysis
Execution	Runs tests with browser automation
Evaluation	Produces scored reports with findings

Output

┌─────────────────────────────────────────┐
│  UI/UX QA Agent                         │
├─────────────────────────────────────────┤
│  ✓ Init        → Browser ready          │
│  ✓ Discovery   → Found 5 pages          │
│  ✓ Planning    → 12 test steps          │
│  ● Execution   → Running tests...       │
│  ○ Evaluation  → Pending                │
└─────────────────────────────────────────┘

Results include markdown reports, JSON data, and screenshots saved to .ui-qa-runs/.