Icon Set Consistency Checker

An icon set behaves more like a typeface than a collection of drawings, and consistency is what lets a user read a row of glyphs as one alphabet. The scored dimensions correspond to the properties that break that reading first. Stroke width carries the heaviest weight at 30 percent because a 1.5 px line sitting beside a 2 px line reads as a difference in emphasis the viewer cannot account for. Grid size matters because icons drawn at different densities do not align on a shared baseline and blur when scaled: 16 px is conventional for dense toolbars, 24 px for standard interface icons, and 32 to 48 px for display use, with multiples of 8 preferred so icons snap to common spacing scales. The keyline figure of 90 percent of the grid and the safe zone of one sixteenth reflect the padding conventions of mainstream design systems, which reserve a margin so glyphs never touch the bounding box. Optical correction is the part that resists automation. A circle inscribed in a 24 px square encloses only about 79 percent of the area of a square filling the same box, so circular glyphs are normally drawn 4 to 8 percent oversize and triangular forms more still, because the eye judges apparent mass rather than bounding-box dimensions. That is why mature sets publish separate keyline shapes for square, circle, vertical rectangle and horizontal rectangle. The clear limitation of a score like this is that it counts declared variations rather than inspecting artwork: it cannot detect corner radius drift, mismatched terminal caps, inconsistent perspective, or two icons that share a stroke width but differ sharply in visual density. Read the grade as triage guidance, and the effort estimate of roughly 15 minutes per icon as an order-of-magnitude figure for redraw work alone.

Interface icons as a designed system date to the Xerox Star workstation released in 1981, which introduced a desktop metaphor of documents, folders and a printer rendered as small bitmap pictures. Susan Kare produced the icon set for the original Apple Macintosh in 1983 and 1984, drawing each glyph on graph paper cell by cell at sizes of 32 by 32 pixels or smaller. At that resolution every pixel was a deliberate decision, which enforced consistency by necessity: there was no room to vary stroke weight or apply optical adjustments finer than a whole pixel. Published icon guidelines came much later, driven by the need to keep large platform libraries coherent across many contributors. Google released Material Design in 2014 with an explicit 24 by 24 dp system icon grid, a 20 dp live area, and documented keyline shapes for circular and rectangular forms, which became the template most subsequent open icon sets copied. Apple introduced SF Symbols in 2019, tying icon weight directly to the weights of the San Francisco typeface so glyphs match adjacent text optically at any size. Open source libraries sharpened the single-stroke convention further, with Feather standardising on a 24 px grid with 2 px strokes and later sets such as Heroicons settling on 1.5 px. Automated consistency auditing followed these guidelines rather than preceding them.