shadscan: Open-source UI audit tool for React and shadcn/ui without AI

X postOrcDevTool

OrcDev introduced shadscan, a free, open-source quality scanner for React and shadcn/ui applications. It deterministically checks code and rendered pages for missing states, accessibility gaps, overflow bugs, and metadata issues without requiring AI models, accounts, or API keys.

Key points

  1. shadscan performs deterministic UI audits using static code analysis alongside an optional runtime scan.
  2. It flags issues such as missing component states, accessibility flaws, layout overflow, and metadata problems.
  3. Operates entirely without AI, user accounts, or API keys.
  4. Supports Next.js, Vite, React Router, TanStack Start, Laravel with Inertia, Astro with React, and generic React apps.
  5. Can be run via the CLI locally, integrated into CI pipelines, or combined with AI agents to plan fixes.

Why it matters

While many newer code review tools rely on non-deterministic LLMs, shadscan provides predictable, reproducible checks tailored to shadcn/ui components. It allows teams to catch UI and accessibility regressions early in CI without ongoing API costs or privacy trade-offs.

Analysis

Because shadcn/ui relies on copying component code directly into repositories, teams frequently introduce subtle accessibility bugs or overlook edge-case states. shadscan targets these patterns using fast, deterministic static rules. While independent of AI for detection, its output can still be fed to AI agents for automated remediation planning.

Original post

OrcDev

@orcdev · 15 August 2026

Many people asked what shadscan actually does. It's a free, open source UI quality scanner for React + shadcn/ui apps. It catches missing states, accessibility gaps, overflow, metadata issues and more in code and rendered pages. It uses no AI. No API key. No login. Run it t.co/s19xE8lb9b t.co/WEDv66Av8L

133 likes6 replies192 bookmarks42.2k views

View on X
More posts in the thread (7)
  1. Also, show Shadscan some support and give it a star ⭐ t.co/PqyQAiagSP
  2. shadscan supports: Next.js, Vite, React Router, TanStack Start, Laravel + Inertia, Astro + React, and generic React apps.
  3. @kgupta_2005 this can become pretty big
  4. @TheCoderBtw Mostly static analysis, with a separate optional runtime scan. Here is what AI says about it: t.co/4H0qRdfaJf
  5. @ametel01 @shadcn this one is checking your UI, and has many shadcn/ui rules on top of it
  6. @ametel01 @shadcn awesome, thank you! if you need any help I'm here :)
  7. @JasonMoneiva it's not using AI in any way run it with AI just to automate it, and make a plan to fix all problems
Selected replies (5)
  • @ametel01 @orcdev @shadcn How is this different from react-doctor?
  • @kgupta_2005 @orcdev Now that's game changing ig
  • @TheCoderBtw @orcdev How does it detect missing states without AI? Like, does it walk the component tree and look for props that aren't tested, or is it more of a runtime scan?
  • @ametel01 @orcdev @shadcn Thanks I’ll check it out
  • @JasonMoneiva @orcdev If it's deterministic then why run it with AI? Terminal has been baked into every IDE for years.

Mentioned links

Links and tools from this entry

Summary generated by AI (Gemini 3.8 Flash, 27 September 2026). It may contain errors – the original source is authoritative.

Related entries

Similar in content, found by the AI search.

  • Repository:TheOrcDev/shadscan

    shadscan: Deterministic UI audits for shadcn apps

    shadscan is an open-source CLI tool and static analyser for React applications using shadcn/ui. It scores UI fundamentals against 62 rules across terminals, CI pipelines, and AI agent environments.

    538starsTypeScript

    Web development· Tool

  • Repository:shadcn-ui/chatbot-template

    shadcn/ui Chatbot Template: Minimal AI Chat UI with Vercel AI Gateway

    The official chatbot template from shadcn/ui provides a lean reference implementation for AI chat applications. It integrates Next.js, the Vercel AI SDK, and UI components from the shadcn ecosystem, powered by the Vercel AI Gateway.

    910starsTypeScript

    AI & LLMs· Tool

  • Repository:shadcn-ui/lint

    shadcn/lint: Agent-First Linter for Tailwind Design Systems

    shadcn/lint is a linter designed for Tailwind CSS (v4) that enforces design system boundaries with error messages tailored for AI coding agents. Instead of generic type errors, it provides actionable suggestions based on components, variants, and themes.

    2.2kstarsTypeScript

    AI & LLMs· Tool

Back to the knowledge base

Let's talk about your project

Get in touch

Locations

  • Mattersburg
    Johann Nepomuk Bergerstraße 7/2/14
    7210 Mattersburg, Austria
  • Vienna
    Ungargasse 64-66/3/404
    1030 Wien, Austria

Parts of this content were created with the assistance of AI.