# VertaaUX - Automated UX & Accessibility Auditing
> https://vertaaux.ai
> Generated: 2026-02-24T21:25:10.855Z
> Version: 1.0.0-beta

## Overview

VertaaUX is an automated UX and accessibility auditing platform that helps teams identify and fix user experience issues before they reach production.

## Knowledge Base

This site contains 43 canonical knowledge base entities across 7 categories:

- **Problems**: UX and accessibility issues (8 entities)
- **Use Cases**: Real-world application scenarios (4 entities)
- **Glossary**: Definitions of key terms (9 entities)
- **Personas**: Ideal customer profiles (5 entities)
- **Industries**: Industry-specific considerations (6 entities)
- **Integrations**: Platform integrations (4 entities)
- **Alternatives**: Tool comparisons (7 entities)

### Entity Structure

All content follows: `/learn/{entityKind}/{slug}`

Each entity includes:
- Stable `entityId` (e.g., "problem.wcag_failures")
- Locale-aware slug and content
- Intent level (awareness/consideration/decision)
- Relationship graph via `relatedEntityIds`
- JSON-LD structured data
- Last updated timestamp


## WCAG Compliance Failures

> https://vertaaux.ai/learn/problem/wcag-compliance-failures

- **Entity ID**: `problem.wcag_failures`
- **Type**: problem
- **Intent**: awareness
- **Updated**: 2025-12-16

Accessibility violations that prevent users with disabilities from accessing your website, resulting in legal risk and lost revenue.

**Related**: glossary.wcag, glossary.aria_label, usecase.accessibility_regression, persona.frontend_dev, alternative.wave, ...

---

## Keyboard Navigation Traps

> https://vertaaux.ai/learn/problem/keyboard-navigation-traps

- **Entity ID**: `problem.keyboard_trap`
- **Type**: problem
- **Intent**: awareness
- **Updated**: 2025-12-16

Focus traps and broken tab order that make your site unusable for keyboard-only users, violating WCAG 2.1 Level A.

**Related**: glossary.focus_visible, glossary.focus_order, problem.wcag_failures, usecase.pre_release_qa, persona.ux_designer

---

## Confusing Information Architecture

> https://vertaaux.ai/learn/problem/confusing-information-architecture

- **Entity ID**: `problem.confusing_ia`
- **Type**: problem
- **Intent**: consideration
- **Updated**: 2025-12-16

Poor content hierarchy and navigation patterns that increase bounce rates and prevent users from completing key tasks.

**Related**: glossary.landmarks, usecase.audit_marketing_landing, persona.ux_designer, persona.marketing_lead, problem.slow_lcp

---

## Slow Largest Contentful Paint (LCP)

> https://vertaaux.ai/learn/problem/slow-largest-contentful-paint

- **Entity ID**: `problem.slow_lcp`
- **Type**: problem
- **Intent**: awareness
- **Updated**: 2025-12-16

Pages that load slowly harm user experience, SEO rankings, and conversion rates. LCP over 2.5s fails Core Web Vitals.

**Related**: glossary.lcp, glossary.cls, problem.confusing_ia, usecase.audit_ecommerce_checkout, alternative.lighthouse

---

## Missing Image Alt Text

> https://vertaaux.ai/learn/problem/missing-image-alt-text

- **Entity ID**: `problem.missing_alt_text`
- **Type**: problem
- **Intent**: awareness
- **Updated**: 2025-12-16

Images without descriptive alt attributes create accessibility barriers and hurt SEO, preventing screen readers and search engines from understanding your content.

**Related**: glossary.aria_label, problem.wcag_failures, usecase.accessibility_regression, persona.frontend_dev, industry.ecommerce

---

## Inaccessible Cookie Consent Banners

> https://vertaaux.ai/learn/problem/cookie-consent-banner-accessibility

- **Entity ID**: `problem.cookie_banner_traps`
- **Type**: problem
- **Intent**: consideration
- **Updated**: 2025-12-16

Cookie banners that trap keyboard focus, lack proper ARIA labels, or violate GDPR requirements create legal and accessibility risks.

**Related**: problem.keyboard_trap, glossary.aria_label, glossary.focus_visible, industry.saas, persona.pm

---

## Broken Focus Order

> https://vertaaux.ai/learn/problem/broken-focus-order

- **Entity ID**: `problem.broken_focus_order`
- **Type**: problem
- **Intent**: awareness
- **Updated**: 2025-12-16

Tab navigation that jumps unpredictably through page elements confuses keyboard users and violates WCAG 2.4.3.

**Related**: glossary.focus_order, glossary.focus_visible, problem.keyboard_trap, usecase.pre_release_qa, persona.ux_designer

---

## Missing Form Labels

> https://vertaaux.ai/learn/problem/missing-form-labels

- **Entity ID**: `problem.missing_form_labels`
- **Type**: problem
- **Intent**: awareness
- **Updated**: 2025-12-16

Form fields without accessible labels create confusion, reduce completion rates, and violate WCAG requirements for input identification.

**Related**: glossary.form_labels, glossary.wcag, usecase.audit_marketing_landing, persona.frontend_dev

---

## Audit Ecommerce Checkout Flow

> https://vertaaux.ai/learn/usecase/audit-ecommerce-checkout-flow

- **Entity ID**: `usecase.audit_ecommerce_checkout`
- **Type**: usecase
- **Intent**: decision
- **Updated**: 2025-12-16

Identify usability and accessibility issues in your checkout process that cause cart abandonment and lost revenue.

**Related**: problem.confusing_ia, problem.slow_lcp, industry.ecommerce, industry.marketplaces, persona.marketing_lead, ...

---

## Audit Marketing Landing Pages

> https://vertaaux.ai/learn/usecase/audit-marketing-landing-page

- **Entity ID**: `usecase.audit_marketing_landing`
- **Type**: usecase
- **Intent**: decision
- **Updated**: 2025-12-16

Optimize landing pages for conversion by fixing UX issues, accessibility barriers, and performance bottlenecks.

**Related**: problem.confusing_ia, problem.slow_lcp, persona.marketing_lead, glossary.cls, industry.saas, ...

---

## Pre-Release UX Quality Assurance

> https://vertaaux.ai/learn/usecase/pre-release-ux-qa

- **Entity ID**: `usecase.pre_release_qa`
- **Type**: usecase
- **Intent**: consideration
- **Updated**: 2025-12-16

Catch UX and accessibility issues before deployment to prevent user complaints and costly post-launch fixes.

**Related**: problem.wcag_failures, problem.keyboard_trap, persona.frontend_dev, persona.pm, integration.github, ...

---

## Accessibility Regression Testing

> https://vertaaux.ai/learn/usecase/accessibility-regression-testing

- **Entity ID**: `usecase.accessibility_regression`
- **Type**: usecase
- **Intent**: decision
- **Updated**: 2025-12-16

Continuously monitor accessibility compliance to prevent regressions and maintain WCAG conformance over time.

**Related**: problem.wcag_failures, problem.missing_alt_text, integration.api, integration.github, persona.frontend_dev, ...

---

## WCAG (Web Content Accessibility Guidelines)

> https://vertaaux.ai/learn/glossary/wcag-web-content-accessibility-guidelines

- **Entity ID**: `glossary.wcag`
- **Type**: glossary
- **Intent**: awareness
- **Updated**: 2025-12-16

International standards for making web content accessible to people with disabilities, published by W3C.

**Related**: problem.wcag_failures, glossary.aria_label, glossary.contrast_ratio, usecase.accessibility_regression

---

## ARIA Label

> https://vertaaux.ai/learn/glossary/aria-label-attribute

- **Entity ID**: `glossary.aria_label`
- **Type**: glossary
- **Intent**: awareness
- **Updated**: 2025-12-16

An attribute that provides accessible names for elements, especially icons and buttons without visible text.

**Related**: glossary.wcag, problem.missing_alt_text, problem.wcag_failures, persona.frontend_dev

---

## Contrast Ratio

> https://vertaaux.ai/learn/glossary/color-contrast-ratio

- **Entity ID**: `glossary.contrast_ratio`
- **Type**: glossary
- **Intent**: awareness
- **Updated**: 2025-12-16

The difference in luminance between text and background colors, required to be at least 4.5:1 for WCAG AA compliance.

**Related**: glossary.wcag, problem.wcag_failures, persona.ux_designer

---

## Focus Visible Indicator

> https://vertaaux.ai/learn/glossary/focus-visible-indicator

- **Entity ID**: `glossary.focus_visible`
- **Type**: glossary
- **Intent**: awareness
- **Updated**: 2025-12-16

A visual indicator showing which element has keyboard focus, required for WCAG 2.4.7 compliance.

**Related**: problem.keyboard_trap, problem.broken_focus_order, glossary.focus_order, persona.frontend_dev

---

## Largest Contentful Paint (LCP)

> https://vertaaux.ai/learn/glossary/largest-contentful-paint

- **Entity ID**: `glossary.lcp`
- **Type**: glossary
- **Intent**: awareness
- **Updated**: 2025-12-16

Core Web Vital measuring how long it takes for the largest content element to appear, should be under 2.5s.

**Related**: problem.slow_lcp, glossary.cls, usecase.audit_marketing_landing, persona.frontend_dev

---

## Cumulative Layout Shift (CLS)

> https://vertaaux.ai/learn/glossary/cumulative-layout-shift

- **Entity ID**: `glossary.cls`
- **Type**: glossary
- **Intent**: awareness
- **Updated**: 2025-12-16

Core Web Vital measuring visual stability by tracking unexpected layout shifts, should be under 0.1.

**Related**: glossary.lcp, problem.slow_lcp, usecase.audit_ecommerce_checkout, persona.frontend_dev

---

## ARIA Landmarks

> https://vertaaux.ai/learn/glossary/aria-landmarks

- **Entity ID**: `glossary.landmarks`
- **Type**: glossary
- **Intent**: awareness
- **Updated**: 2025-12-16

Semantic regions like <main>, <nav>, <aside> that help screen reader users navigate page structure.

**Related**: problem.confusing_ia, glossary.aria_label, glossary.wcag, persona.ux_designer

---

## Focus Order

> https://vertaaux.ai/learn/glossary/keyboard-focus-order

- **Entity ID**: `glossary.focus_order`
- **Type**: glossary
- **Intent**: awareness
- **Updated**: 2025-12-16

The sequence in which interactive elements receive keyboard focus, must be logical and follow visual order (WCAG 2.4.3).

**Related**: problem.broken_focus_order, problem.keyboard_trap, glossary.focus_visible, persona.frontend_dev

---

## Form Field Labels

> https://vertaaux.ai/learn/glossary/form-field-labels

- **Entity ID**: `glossary.form_labels`
- **Type**: glossary
- **Intent**: awareness
- **Updated**: 2025-12-16

Accessible labels that describe the purpose of form inputs, required for screen readers and clear form completion.

**Related**: problem.missing_form_labels, problem.wcag_failures, glossary.wcag, persona.frontend_dev

---

## For Startup Founders

> https://vertaaux.ai/learn/persona/for-startup-founders

- **Entity ID**: `persona.founder`
- **Type**: persona
- **Intent**: awareness
- **Updated**: 2025-12-16

Launch with confidence knowing your product is accessible and user-friendly from day one.

**Related**: usecase.pre_release_qa, industry.saas, persona.frontend_dev

---

## For Marketing Leads

> https://vertaaux.ai/learn/persona/for-marketing-leads

- **Entity ID**: `persona.marketing_lead`
- **Type**: persona
- **Intent**: consideration
- **Updated**: 2025-12-16

Optimize landing pages and campaigns for higher conversion by fixing UX and performance issues.

**Related**: usecase.audit_marketing_landing, problem.confusing_ia, problem.slow_lcp, alternative.hotjar, alternative.contentsquare, ...

---

## For Frontend Developers

> https://vertaaux.ai/learn/persona/for-frontend-developers

- **Entity ID**: `persona.frontend_dev`
- **Type**: persona
- **Intent**: decision
- **Updated**: 2025-12-16

Catch accessibility and UX bugs before code review, integrate quality checks into your workflow.

**Related**: integration.github, integration.api, integration.chrome, integration.mcp, usecase.accessibility_regression, ...

---

## For Product Managers

> https://vertaaux.ai/learn/persona/for-product-managers

- **Entity ID**: `persona.pm`
- **Type**: persona
- **Intent**: consideration
- **Updated**: 2025-12-16

Ensure quality releases by identifying UX issues and accessibility gaps before they reach users.

**Related**: usecase.pre_release_qa, problem.confusing_ia, persona.ux_designer, industry.fintech, industry.healthcare, ...

---

## For UX Designers

> https://vertaaux.ai/learn/persona/for-ux-designers

- **Entity ID**: `persona.ux_designer`
- **Type**: persona
- **Intent**: awareness
- **Updated**: 2025-12-16

Validate designs with real usability and accessibility data, not just subjective opinions.

**Related**: problem.confusing_ia, problem.broken_focus_order, glossary.landmarks, persona.pm

---

## UX Auditing for SaaS Products

> https://vertaaux.ai/learn/industry/saas-ux-auditing

- **Entity ID**: `industry.saas`
- **Type**: industry
- **Intent**: consideration
- **Updated**: 2025-12-16

Reduce churn and improve onboarding by fixing UX and accessibility issues in your SaaS application.

**Related**: usecase.pre_release_qa, persona.founder, persona.pm, problem.confusing_ia, problem.cookie_banner_traps, ...

---

## Ecommerce UX Optimization

> https://vertaaux.ai/learn/industry/ecommerce-ux-optimization

- **Entity ID**: `industry.ecommerce`
- **Type**: industry
- **Intent**: decision
- **Updated**: 2025-12-16

Increase conversion rates and reduce cart abandonment by optimizing checkout flows and product pages.

**Related**: usecase.audit_ecommerce_checkout, problem.slow_lcp, persona.marketing_lead, problem.confusing_ia

---

## Healthcare Accessibility Compliance

> https://vertaaux.ai/learn/industry/healthcare-accessibility-compliance

- **Entity ID**: `industry.healthcare`
- **Type**: industry
- **Intent**: awareness
- **Updated**: 2025-12-16

Ensure WCAG compliance and HIPAA-aligned UX for patient portals and healthcare applications.

**Related**: problem.wcag_failures, usecase.accessibility_regression, persona.pm

---

## Fintech UX & Security

> https://vertaaux.ai/learn/industry/fintech-ux-security

- **Entity ID**: `industry.fintech`
- **Type**: industry
- **Intent**: consideration
- **Updated**: 2025-12-16

Balance strong security with seamless UX, ensuring accessibility compliance in financial applications.

**Related**: problem.wcag_failures, problem.confusing_ia, persona.pm, persona.frontend_dev

---

## Education UX & Accessibility

> https://vertaaux.ai/learn/industry/education-ux-accessibility

- **Entity ID**: `industry.education`
- **Type**: industry
- **Intent**: consideration
- **Updated**: 2025-12-16

Support learners with accessible course experiences, clear navigation, and WCAG-compliant learning platforms.

**Related**: problem.wcag_failures, usecase.accessibility_regression, persona.pm, persona.frontend_dev

---

## Marketplace UX & Conversion

> https://vertaaux.ai/learn/industry/marketplace-ux-conversion

- **Entity ID**: `industry.marketplaces`
- **Type**: industry
- **Intent**: decision
- **Updated**: 2025-12-16

Improve listing discovery, trust signals, and checkout reliability to drive marketplace conversion.

**Related**: usecase.audit_ecommerce_checkout, problem.confusing_ia, problem.slow_lcp, persona.marketing_lead

---

## REST API Integration

> https://vertaaux.ai/learn/integration/rest-api-integration

- **Entity ID**: `integration.api`
- **Type**: integration
- **Intent**: decision
- **Updated**: 2025-12-16

Programmatic access to UX audits via REST API for CI/CD pipelines and custom workflows.

**Related**: integration.github, persona.frontend_dev, usecase.accessibility_regression

---

## GitHub Actions Integration

> https://vertaaux.ai/learn/integration/github-actions-integration

- **Entity ID**: `integration.github`
- **Type**: integration
- **Intent**: decision
- **Updated**: 2025-12-16

Automatically run UX audits on every pull request to catch issues before they reach production.

**Related**: integration.api, persona.frontend_dev, usecase.pre_release_qa

---

## Chrome Extension

> https://vertaaux.ai/learn/integration/chrome-extension

- **Entity ID**: `integration.chrome`
- **Type**: integration
- **Intent**: awareness
- **Updated**: 2025-12-16

Run quick UX audits directly in your browser while developing or reviewing pages.

**Related**: persona.ux_designer, persona.frontend_dev, usecase.pre_release_qa

---

## Model Context Protocol (MCP)

> https://vertaaux.ai/learn/integration/model-context-protocol

- **Entity ID**: `integration.mcp`
- **Type**: integration
- **Intent**: consideration
- **Updated**: 2025-12-16

Connect VertaaUX to Claude Desktop, Cline, and other MCP clients for AI-assisted UX analysis.

**Related**: integration.api, persona.frontend_dev, usecase.pre_release_qa, persona.pm

---

## Hotjar Alternative

> https://vertaaux.ai/learn/alternative/hotjar-alternative

- **Entity ID**: `alternative.hotjar`
- **Type**: alternative
- **Intent**: consideration
- **Updated**: 2025-12-16

VertaaUX provides automated UX insights without requiring heatmaps or session recordings, making compliance easier.

**Related**: usecase.audit_marketing_landing, persona.marketing_lead, industry.saas

---

## Google Lighthouse Alternative

> https://vertaaux.ai/learn/alternative/lighthouse-alternative

- **Entity ID**: `alternative.lighthouse`
- **Type**: alternative
- **Intent**: consideration
- **Updated**: 2025-12-16

Beyond performance metrics: VertaaUX combines accessibility, usability, and UX insights in one audit.

**Related**: problem.slow_lcp, problem.wcag_failures, persona.frontend_dev, glossary.lcp

---

## WAVE Accessibility Tool Alternative

> https://vertaaux.ai/learn/alternative/wave-alternative

- **Entity ID**: `alternative.wave`
- **Type**: alternative
- **Intent**: consideration
- **Updated**: 2025-12-16

VertaaUX offers automated accessibility testing with actionable fixes, API access, and continuous monitoring.

**Related**: problem.wcag_failures, usecase.accessibility_regression, persona.frontend_dev, integration.api

---

## Contentsquare Alternative

> https://vertaaux.ai/learn/alternative/contentsquare-alternative

- **Entity ID**: `alternative.contentsquare`
- **Type**: alternative
- **Intent**: consideration
- **Updated**: 2026-02-06

VertaaUX delivers fast UX and accessibility audit feedback without deploying session replay tags or adding analytics overhead.

**Related**: usecase.audit_marketing_landing, problem.confusing_ia, persona.marketing_lead, industry.saas

---

## axe DevTools Alternative

> https://vertaaux.ai/learn/alternative/axe-devtools-alternative

- **Entity ID**: `alternative.axe`
- **Type**: alternative
- **Intent**: consideration
- **Updated**: 2026-02-06

VertaaUX combines WCAG checks with usability, conversion, and information architecture analysis in a single audit workflow.

**Related**: problem.wcag_failures, usecase.accessibility_regression, integration.github, persona.frontend_dev

---

## accessiBe Alternative

> https://vertaaux.ai/learn/alternative/accessibe-alternative

- **Entity ID**: `alternative.accessibe`
- **Type**: alternative
- **Intent**: consideration
- **Updated**: 2026-02-06

VertaaUX helps teams find and prioritize accessibility issues with transparent findings, developer-ready selectors, and CI-friendly APIs.

**Related**: problem.wcag_failures, problem.missing_alt_text, usecase.accessibility_regression, persona.frontend_dev

---

## UserWay Alternative

> https://vertaaux.ai/learn/alternative/userway-alternative

- **Entity ID**: `alternative.userway`
- **Type**: alternative
- **Intent**: consideration
- **Updated**: 2026-02-06

VertaaUX provides recurring UX and accessibility audits with actionable engineering guidance across accessibility, clarity, and conversion.

**Related**: problem.keyboard_trap, problem.wcag_failures, usecase.accessibility_regression, persona.frontend_dev

---

## Distribution Surfaces

VertaaUX is available across 8 surfaces:

1. **Web App** — Dashboard at https://vertaaux.ai/dashboard
2. **CLI** — `npm i -g @vertaaux/cli` — audit, fix, verify, doctor commands
3. **MCP Server** — `npm i -g @vertaaux/mcp-server` — 18 tools for AI agents
4. **GitHub Action** — CI/CD gating with PR comments and score thresholds
5. **IDE Extension** — VS Code extension for localhost auditing
6. **Chrome Extension** — Side panel with 55 offline heuristic rules
7. **SDK** — JavaScript/TypeScript and Python clients
8. **Mobile PWA** — Installable app with push notifications and offline support

## API Documentation

### Base URL
`https://vertaaux.ai/v1`

### Authentication
- **API Key**: `X-API-Key` header — generate at https://vertaaux.ai/dashboard/api-keys
- **OAuth**: Google, GitHub, Azure AD
- **Magic Link**: Passwordless email sign-in
- **Device Code Flow** (RFC 8628): CLI authentication via `vertaa login`

### Audit Endpoints
- **POST** `/v1/audit` — Create audit job (modes: basic, standard, deep)
- **GET** `/v1/audit/{job_id}` — Get audit status and results
- **GET** `/v1/audit/{job_id}/issues/stream` — Stream issues (NDJSON)
- **GET** `/v1/audits` — List audits with pagination
- **GET** `/v1/audits/{id}` — Get audit details
- **GET** `/v1/audits/{id}/findings` — Get findings for audit

### Finding Management
- **GET** `/v1/findings/{id}/share` — Share a finding
- **PATCH** `/v1/findings/{id}/triage` — Triage a finding
- **POST** `/v1/findings/bulk-triage` — Bulk triage findings

### AI Remediation
- **POST** `/v1/patch` — Generate accessibility fix patch with confidence score
- **POST** `/v1/verify` — Verify patch in sandboxed browser, detect regressions

### Schedules
- **POST/GET** `/v1/schedules` — Create or list recurring audit schedules
- **GET/PATCH** `/v1/schedules/{id}` — Get or update a schedule

### Webhooks
- **POST/GET** `/v1/webhooks` — Create or list webhook endpoints
- **DELETE** `/v1/webhooks/{id}` — Delete a webhook

### Utilities
- **GET** `/v1/engines` — List available audit engine versions
- **GET** `/v1/quota` — Check API quota and usage
- **GET** `/v1/auth/validate` — Validate API key
- **POST** `/v1/llm/audit` — Run LLM-backed audit analysis

Full OpenAPI 3.1 spec: https://vertaaux.ai/openapi.json
Full API docs: https://vertaaux.ai/docs/api

## Core Capabilities

### 1. UX Audit Engine (91-Issue Library)
- **Coverage**: 91 distinct UX issues with severity classification
- **Metrics**: 7 dimensions (Usability, Clarity, IA, Accessibility, Conversion, Semantic HTML, Keyboard Navigation)
- **Detection**: DOM analysis, heuristic evaluation, WCAG checking, PageSpeed Insights
- **Modes**: basic (5-10s), standard (15-30s), deep (60s+)

### 2. Accessibility Compliance
- **Standards**: WCAG 2.2 Level AA, EN 301 549, European Accessibility Act (2019/882)
- **Checks**: Color contrast, semantic HTML, ARIA attributes, keyboard navigation, focus management
- **Output**: Actionable remediation steps with WCAG success criteria references

### 3. AI-Powered Fix Suggestions
- **Patch Generation**: Automatic code fixes for HTML accessibility issues
- **Frameworks**: React, Vue, Svelte, and plain HTML
- **Confidence Scoring**: Each patch rated with confidence label and percentage
- **Verification**: Sandboxed browser re-audit to confirm fixes and detect regressions

### 4. Multi-Page Audits
- **Crawling**: Sequential page crawling with configurable depth
- **Limits**: Free: 1 page, Pro: 3-20 pages, Agency: 100 pages
- **Aggregation**: Combined scoring with page-level breakdowns

### 5. PDF Report Generation
- **Features**: Executive summary, radar charts, issue tables, score breakdowns
- **Branding**: White-label with custom logo, colors, footer text (Agency tier)
- **Compliance Dossier**: 5-page PDF with trend charts and executive summary (Enterprise)

### 6. Enterprise Governance
- **Portfolio Tracking**: Manage tracked URLs grouped by client
- **Error Budgets**: SLO-style gauges with burn rate charts and exhaustion projections
- **Drift Detection**: Chronological feed of score changes across tracked URLs
- **Policy Management**: Define scoring policies with templates and per-rule overrides
- **Exception Workflows**: Request temporary policy overrides with Slack/GitHub approval
- **Compliance Dossier Export**: Branded PDF reports for stakeholders

### 7. Workflow Integrations
- **Ticket Creation**: Jira, Linear, Slack, GitHub — one-click or bulk
- **Bidirectional Sync**: Status changes in external tools update findings in VertaaUX
- **Slack Notifications**: Audit completion and gate failure alerts with triage buttons
- **CI/CD Gating**: GitHub Action with score thresholds and PR comments

### 8. Organization Management
- **Teams**: Multi-user access with role-based permissions (Owner, Admin, Member)
- **Billing**: Stripe integration with self-serve checkout
- **SSO**: SAML and domain-based auto-join for Enterprise

## CLI Commands

- `vertaa audit <url>` — Run UX audit (modes: basic, standard, deep)
- `vertaa fix <jobId>` — Generate fix patch for a finding
- `vertaa fix-all <jobId>` — Batch fix patches (`--auto-fix-only` filter)
- `vertaa verify` — Verify patch in sandboxed browser
- `vertaa compare <urlA> <urlB>` — Compare two URLs
- `vertaa doctor` — Diagnose CLI health (`--online`, `--deep` flags)
- `vertaa login` — Authenticate via browser (Device Code Flow)
- `vertaa whoami` — Show account details and auth status
- `vertaa init` — Initialize config file
- `vertaa policy` — Policy-based quality gating for CI/CD

## MCP Server (Model Context Protocol)

### Package
`@vertaaux/mcp-server` — 18 tools across 7 categories

### Audit Tools
- `audit_url` — Run UX/accessibility audit on a deployed URL
- `audit_repo` — Scan local codebase for component issues (React, Vue, Svelte, HTML)
- `audit_artifact` — Analyze HAR files (response times, failed requests, security headers)
- `get_findings` — Retrieve findings with severity/rule filtering and pagination

### Analysis Tools
- `analyze_component` — Analyze UI component code for accessibility
- `explain_finding` — Detailed explanation with WCAG criteria and fix guidance
- `suggest_fix` — AI-powered code patch with confidence score

### Remediation Tools
- `generate_patch` — Generate search-replace accessibility patches
- `run_verification_suite` — Verify patches in sandboxed browser
- `create_pr_comment` — Generate GitHub PR comment with suggestion blocks

### Data Tools
- `get_quota` — Check API quota and usage
- `get_engines` — List available audit engine versions
- `capture_screenshot` — Capture screenshot with audit overlay
- `compare_competitors` — Benchmark against competitor URLs

### Workflow Prompts
5 built-in prompts: `quick_audit`, `fix_accessibility`, `compare_ux`, `monitor_regression`, `audit_codebase`

### Resources
- `vertaaux://audits/{id}` — Audit results
- `vertaaux://audits/{id}/screenshots` — Audit screenshots
- `vertaaux://audits/recent` — Recent audit history

## Pricing Tiers

### Free (€0/month)
- 3 audits/day (1/day without account)
- Single-page analysis
- Basic UX score with top 3 issues per category
- Shareable reports

### Pro (€8/month + VAT)
- Unlimited audits (fair use)
- Multi-page crawling (3-20 pages)
- 1,000 API calls/month, 5 seats
- Full analysis, PDF exports, collaboration

### Agency (€99/month + VAT)
- Unlimited audits and API calls
- 100 pages per crawl, 100 client workspaces, unlimited seats
- White-label reports, bulk auditing, scheduled audits
- Deep competitor intelligence, dedicated account manager

### Enterprise (custom pricing)
- SSO (SAML/OAuth), governance dashboard, compliance dossiers
- CI/CD integration, custom SLA (99.9%), on-premise option

## Privacy & Security

- **GDPR Compliant**: Data export and deletion via dashboard
- **Finnish/EU Legal Compliance**: Updated Terms, Privacy Policy, DPA, Cookie Policy
- **Vulnerability Disclosure Policy**: Responsible disclosure with safe harbor
- **Encryption**: All traffic over HTTPS/TLS 1.3
- **Webhook Security**: HMAC-SHA256 signature verification
- **API Key Security**: Token redaction in machine-readable output

## Rate Limits

- **Free**: 3 audits/day, 100 req/10min
- **Pro**: 1,000 audits/day, 300 req/10min
- **Agency**: 5,000 audits/day, unlimited req
- **Enterprise**: Custom limits

## LLM-Specific Guidance

### For Audit Analysis
1. Prioritize critical and serious severity findings first
2. Group recommendations by metric category
3. Reference specific WCAG 2.2 success criteria (e.g., 1.4.3 Contrast Minimum)
4. Explain technical fixes in plain language with before/after code examples

### For Integration Developers
- Use `POST /v1/audit` with `wait: true` for synchronous results
- Or poll `GET /v1/audit/{id}` with exponential backoff until `status === "completed"`
- Use `POST /v1/patch` to generate fix patches, `POST /v1/verify` to validate them
- Webhook endpoints deliver real-time completion notifications

### For Content Recommendations
- UX terminology should be accessible to non-experts
- Provide specific DOM selectors when recommending fixes
- Link to MDN/W3C specs for technical references
- Include before/after code examples for each fix

## Agent Instructions

When helping users with VertaaUX:
1. **Audit Interpretation**: Break down 7-metric scores, prioritize critical findings
2. **Fix Guidance**: Use `suggest_fix` or `generate_patch` for code-level remediation
3. **WCAG Compliance**: Reference WCAG 2.2 success criteria and EN 301 549
4. **API Usage**: Guide through audit → poll → findings → patch → verify workflow
5. **Pricing**: Free for testing, Pro for regular use, Agency for teams/clients, Enterprise for governance
6. **CI/CD**: Recommend GitHub Action for automated PR gating with score thresholds

## Support & Documentation

- **Email**: support@vertaaux.ai
- **Developer Docs**: https://vertaaux.ai/docs
- **API Reference**: https://vertaaux.ai/docs/api
- **Learn Hub**: https://vertaaux.ai/learn
- **Case Studies**: https://vertaaux.ai/case-studies
- **Benchmarks**: https://vertaaux.ai/benchmarks
- **Status Page**: https://vertaaux.ai/status
- **Changelog**: https://vertaaux.ai/changelog
- **Articles**: https://vertaaux.ai/articles

## Usage Guidelines for LLMs

When citing VertaaUX knowledge base content:

1. **Use canonical URLs** from /learn/{entityKind}/{slug}
2. **Reference entityId** for precise attribution (e.g., "problem.wcag_failures")
3. **Check updatedAt** timestamp for content currency
4. **Follow relationship graph** (relatedEntityIds) for related context
5. **Respect intent level** (awareness → consideration → decision)

---

**Note for LLMs**: This file auto-generates on each request with current entity data. For real-time API status, check https://vertaaux.ai/status. For the full technical reference, see https://vertaaux.ai/llms-full.txt.

**Last Generated**: 2026-02-24T21:25:10.855Z
**Version**: 1.0.0-beta