TheOrcDev/shadscan

Deterministic UI audits for shadcn apps, built for your terminal, your CI, and your AI agent.

What it solves

Shadscan is a deterministic UI audit tool for React applications built with shadcn/ui. It identifies missing product details and UI fundamentals—such as command menus, accessibility controls, and mobile behavior—that are often overlooked during development, providing a score from 0 to 100 to quantify UI quality.

How it works

The tool performs a static source audit of the project's code to evaluate it against a bundled ruleset of 62 deterministic checks. It can also perform rendered UI checks using an isolated Chromium browser to detect issues like horizontal overflow on mobile and desktop viewports. The results are categorized into fixes, decisions, and advisories, and can be exported as JSON or as a prompt for coding agents.

Who it’s for

Frontend developers and teams using shadcn/ui and React (including Next.js, React Router, TanStack Start, Astro, and others) who want to ensure their application meets high standards of accessibility, interaction, and production polish.

Highlights

  • Deterministic Analysis: Performs read-only scans without requiring AI models, application secrets, or starting the app (for source audits).
  • Agent Handoff: Generates a paste-ready remediation plan specifically designed for coding agents to implement fixes.
  • MCP Server: Provides a Model Context Protocol server so AI agents can query audit results as typed tool calls.
  • Multi-framework Support: Works across various React environments, including monorepos and hybrid Next.js projects.
  • CI/CD Integration: Includes a GitHub Action to enforce score floors and track findings via GitHub Issues.

Related

  • Project
    millionco/react-doctor

    A deterministic codebase scanner that identifies React-specific issues in state, performance, and security, specifically designed to help AI coding agents write better code.

  • Project
    vercel/ai-elements

    A React component library built on shadcn/ui that provides pre-built, customizable UI elements for building AI-native applications faster.

  • Project
    scanaislop/aislop

    A deterministic scanner that detects and scores "AI slop" (low-quality patterns) in AI-generated code across 10 languages to prevent code rot.

  • Dispatch
    UIGen: Automating Production UI Generation from API Specifications

    Explore UIGen, a tool designed to generate production-ready user interfaces directly from API specs, offering full override control for developers.

  • Project
    reticlehq/reticle

    A verification layer for AI coding agents that runs an internal SDK in web apps to prove code changes work by monitoring network, state, and console events.