@mcp-perfectpixel/core
v0.1.3
Published
Deterministic capture + pixel-diff engine for mcp-perfectpixel: screenshots a URL and diffs it against a static design image, returning grouped diff regions with severity scores.
Maintainers
Readme
@mcp-perfectpixel/core
Framework-agnostic capture + pixel-diff engine behind
mcp-perfectpixel.
- Deterministic Playwright capture (fixed locale/timezone, reduced motion, animations disabled, fonts awaited).
- pixelmatch diff with connected-component region grouping, merging, and
severity scoring; optional
textRegionThresholdpass that drops text anti-aliasing noise. - Region → source tracing: CSS source maps (hand-rolled source-map v3 decoder), then gitignore-aware text search, with confidence scoring and platform presets (Shopify / BigCommerce / HTML+Tailwind / React / Vue).
- Minimal patch suggestions derived from design-image pixels, preferring design
tokens the project already defines (CSS custom properties, SCSS
$vars, Tailwind config, style-dictionary JSON, Shopify{%- schema -%}settings) — with Figma-resolved tokens (designContext.tokens) treated as ground truth and Figma node boxes (designContext.nodes) naming each region's layer.
No MCP dependency — reuse the engine for other tooling.
License
MIT
