shadscan
Updated 2026-07-23

Embeds
Add interesting embeds to your website or README.
Deterministic UI audits for shadcn apps — for your terminal, CI, and AI agent.
Shadscan inspects a React shadcn app, scores its UI fundamentals from 0 to 100, and shows the evidence behind every finding. It catches product details that are easy to postpone: command menus, theme shortcuts, route states, accessible controls, form feedback, metadata, mobile behavior, and more.
The default scan is deterministic and read-only. It does not start the app, edit files, call an AI model, upload source, or require application secrets.
Quick start
pnpm dlx @shadscan/cli
Or with npm / Bun: npx --yes @shadscan/cli · bunx @shadscan/cli
What you get
A scored report across Foundation, Interaction, States, Accessibility, Forms and Data Entry, and Production Polish. Findings are split into Fixes, Decisions, Advisories, and Not applicable — with repository-relative evidence and agent-ready remediation prompts.
CI & agents
# Machine-readable report pnpm dlx @shadscan/cli --json # Paste-ready plan for a coding agent pnpm dlx @shadscan/cli --prompt # Fail CI below a score floor pnpm dlx @shadscan/cli --fail-under 80 --no-interactive