Another unexpected challenge emerged around language. Product teams—particularly those working with CMS platforms—often used different terminology than the design system. For example, elements described as “components” in the system were referred to as “sections” in the CMS environment.
To address this, we aligned terminology where possible and clarified definitions in documentation to reduce misunderstandings.
Adoption began naturally with designers, by integrating the system into Figma libraries, designers could start using shared tokens and components directly in their workflows. However, adoption across product teams proved more complex.
Engineers often encountered designs built with system components that had not yet been implemented in their codebases. This created friction between design and development. Rather than avoiding this friction, we used it to highlight the need for adoption.
Teams gradually realized that delivering features would become easier once the design system was integrated into their workflows. To support this transition, I introduced a contribution model that defined how designers and engineers could participate in the system’s evolution. The model provided a clear process for requesting components, reporting issues, and contributing improvements. This contribution flow was documented on our platform and regularly referenced during discussions with product teams.