MCP server

GridProof MCP: Audit Spacing and Grid Rules With Playwright

GridProof renders a running frontend with Playwright, measures the real computed geometry of every element, and reports spacing, gap and tap-target violations with fix hints.

Run
claude mcp add gridproof -- npx -y gridproof
View on GitHub

Stars, license and last push from GitHub. Install count as reported by the open skills directory.

What is GridProof?

GridProof is an MCP server with two tools: gp_audit, which checks a running dev server's computed geometry against spacing-scale, arbitrary-value, gap-consistency and canonical-size rules and returns JSON violations with fix hints, and gp_report, which adds a shareable HTML report. It needs a Playwright-installed Chromium and works best against Tailwind CSS pages.

GridProof checks whether a rendered page actually follows its own spacing rules. It uses Playwright to load a running dev server, reads the computed geometry of every element, and compares that against a spacing and grid rule set.

It works from real computed geometry, not a screenshot or a vision model, and it works best on Tailwind CSS pages; pages without Tailwind still get the accessibility-related tap-target check.

The four rules it checks

RuleWhat it flags
spacing-scaleMargin, padding or gap not aligned to the base unit, 4px by default
arbitrary-valueOff-scale arbitrary Tailwind utility classes in the rendered DOM
gap-consistencyInconsistent spacing between sibling flex or grid items with no explicit gap
canonical-sizeIcons off a canonical size scale, and tap targets under the 44px WCAG 2.5.8 floor

What it deliberately does not do

GridProof does not run computer-vision or screenshot analysis, does not act as a CI build gate with pass or fail exit codes, and does not edit source files itself. An agent reads its JSON output and makes the fix.

Who it is for

Best for

  • Tailwind projects where an agent keeps writing off-scale spacing values that a human reviewer would otherwise have to catch by eye.
  • Teams who want a tap-target accessibility floor checked automatically alongside spacing consistency.
  • Workflows that want a shareable HTML report of spacing issues, not just a terminal log.

Not for

  • If the bug is clipped text or a contrast failure caught from rendered pixels rather than spacing math, Squint MCP checks those pixels against the DOM and CSS instead.
  • When the comparison target is a Figma frame rather than a spacing rule set, Designfit MCP checks that geometry and those tokens against the frame directly.
  • If what you want is a line-level design linter across many weighted dimensions rather than four spacing rules, UI UX Suite MCP scores a project and cites the exact line to fix.
  • When the reference is a whole page's contract rather than a spacing scale, pixelpact MCP Server measures that reference and returns the properties to fix.

Use it with UiChemy

GridProof checks spacing on a page you already built and can run locally. UiChemy Composer builds that page's structure inside Elementor or Gutenberg in the first place. Click Get Started on uichemy.com.