TLDR Design · OPINIONS & TUTORIALS

SIX COMMON MISTAKES IN DESIGN TOKENS NAMING

designtokens.substack.com4 min read

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.