JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 12652
  • Score
    100M100P100Q127323F
  • License SEE LICENSE FILE

Detect UI anti-patterns and design quality issues from the command line

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (impeccable) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    Impeccable CLI

    Detect UI anti-patterns and design quality issues from the command line. Scans HTML, CSS, JSX, TSX, Vue, and Svelte files for 25 specific patterns including AI-generated UI tells, accessibility violations, and general design quality problems.

    Quick Start

    # Scan files or directories
npx impeccable detect src/

# Scan a live URL (requires Puppeteer)
npx impeccable detect https://example.com

# JSON output for CI/tooling
npx impeccable detect --json src/

# Regex-only mode (faster, no jsdom)
npx impeccable detect --fast src/

    What It Detects

    AI Slop Tells -- patterns that scream "AI generated this":

    • Side-tab accent borders, gradient text on headings
    • Purple/violet gradients and cyan-on-dark palettes
    • Dark mode with glowing accents, border + border-radius clashes

    Typography Issues -- overused fonts (Inter, Roboto), flat type hierarchy, single font families

    Color & Contrast -- WCAG AA violations, gray text on colored backgrounds, pure black/white

    Layout & Composition -- nested cards, monotonous spacing, everything-centered layouts

    Motion -- bounce/elastic easing, layout property transitions

    Quality -- tiny body text, cramped padding, long line lengths, small touch targets

    25 detections in total. See the full list at impeccable.style.

    Exit Codes

    • 0 -- no issues found
    • 2 -- anti-patterns detected

    Options

    impeccable detect [options] [file-or-dir-or-url...]

  --fast    Regex-only mode (skip jsdom, faster but less accurate)
  --json    Output findings as JSON
  --help    Show help

    Requirements

    • Node.js 18+
    • jsdom (included as dependency, used for HTML scanning)
    • puppeteer (optional, only needed for URL scanning)

    Part of Impeccable

    This CLI is part of Impeccable, a cross-provider design skill pack for AI-powered development tools. The full suite includes 20 steering commands for Claude, Cursor, Gemini, Codex, and more.

    License

    See LICENSE file.