Foundation

Icon grammar

Same hand

RequiredVisual system
ContractIcon grammar
Job
Same hand
Requirement
must specify
States / rules
Canvas (24/18/14), live area, stroke, cap/join, currentColor, optical compensation
Specified means
One grammar
Hardest context
18 vs 14 mixed in one bar
Example

18px, 1.5 stroke, round cap

Counter-example

Random Lucide sizes

How this lives in Building Blocks

Representation: Shared foundation / token / behavior guidance.

Building Blocks should provide shared guidance, semantic roles, examples, and reusable implementation hooks where appropriate. Each product maps those roles to its own theme and documents any justified exceptions.

Do not specify the easy case only.

The source checklist’s hardest-context test is part of what “specified” means: 18 vs 14 mixed in one bar.

On-spec signal

18px, 1.5 stroke, round cap

Failure signal

Random Lucide sizes

Catalog connection

The product-local Catalog should show this row’s actual state for that product using the Catalog contract. Building Blocks documentation can define the baseline, but it does not make a product’s row Specified, Designed, or In code by itself.

See the Catalog contract →