Why does nobody talk about token drift after a team handoff?

Honestly, our design system at the Austin office went from clean to chaos in about 4 months after two senior devs left. The new crew kept adding hex codes straight into components instead of updating the shared tokens, so now our buttons show three different blues and the spacing is all over the place. Has anyone else dealt with a handoff like this, and what did you do to get the token library respected again?

1 comments

1 Comment

leo_price17d ago

Man, token drift is just the visible part of a bigger problem. Nobody ever writes down why the token exists in the first place, so the new folks see a hex code and think it's personal preference. Get someone to write a simple README that explains which token maps to which button state, and paste the link in every component file. That way the library becomes a shortcut, not a mystery.