Open source · Design Systems

Typography Scale Checker

Check heading and text styles against an explicit type scale.

v0.1.0 · Node.js 22+ · MIT

Browse the public repository · View releases

A design system declares a type scale: display is 64px at lg, heading-1 is 40px there, body text is 16px at 1.5. Six months later a pricing card title is 40px because somebody needed it to look right, and it is still marked up as heading-2. Nothing is broken, nothing warns, and the scale has quietly acquired a sixth size.

This walkthrough uses the tool's public README and checked-in example files. Run the command from a repository checkout with Node.js 22+; inspect the source before using it on your own files.

Run the checked-in example

git clone https://github.com/edilec/typography-scale-checker
cd typography-scale-checker
node bin/typography-scale-checker.mjs --root examples

Read the result

Both run under npm run check, so an example that drifts from the tool fails the build.

Where this check stops

Every bound is enforced and reachable from the command line. Exceeding one is an incomplete result with a finding naming the limit — never a silent truncation and never a pass.

Before adapting the command to your own workflow, review the accepted inputs, exit codes and safety boundaries in the README.

Compiled with AI assistance from checked-in public documentation and example scripts. Run the example and review the repository's current documentation before relying on its result.