TLDR Design · OPINIONS & TUTORIALS
SIX COMMON MISTAKES IN DESIGN TOKENS NAMING
Summary from the TLDR Design newsletter
Weak design token names slow searches, inflate duplicates, and turn governance into guesswork, according to six recurring naming mistakes design systems teams make. Common pitfalls include naming tokens after components too early, baking current values like colors or pixel sizes directly into names, and reordering name segments inconsistently. Other traps are mixing casing and separators, using vague modifiers like "primary" without defined scope, and renaming tokens without a phased migration and alias strategy.