Open source · Design Systems

Icon Set Consistency Checker

Find icon naming, size and stroke differences inside a shared icon set.

v0.1.0 · Node.js 22+ · MIT

Browse the public repository · View releases

An icon set starts as one grid, one stroke width and one naming convention. Then a 20px icon arrives from a different file, a hurried export leaves a 1.5px stroke, somebody adds CheckMark.svg next to arrow-left.svg, and a second copy of the back arrow appears under a new name. Every one of those renders fine on its own. Together they are no longer a set.

This walkthrough uses the tool's public README and checked-in example files. Run the command from a repository checkout with Node.js 22+.

Run the checked-in example

node bin/icon-set-consistency-checker.mjs --root examples/clean --policy icon-policy.json

Read the result

stdout carries the JSON report and nothing else, so it pipes straight into a parser. stderr carries the human summary and diagnostics.

Scope

Every bound is enforced and reachable from the command line, and no bound is ever a silent truncation.