Design System Tactics.

Whether you're starting fresh or maintaining a mature system, this growing collection of tactics is designed to help you make progress at every stage.

Component Retire & Replace

A plan for sunsetting legacy components or tokens in a safe, visible, and supportive way.

When to use it

When rolling out new system versions or simplifying duplicated assets.

Steps

  1. Identify components to deprecate.
  2. Tag old components in docs/code as “deprecated.”
  3. Provide a direct replacement and migration instructions, including when the component will be deprecated on each platform.
  4. Offer a checklist, codemod, or outreach.
  5. Track adoption across teams.

Outcome

  • Fewer legacy components in use
  • Smoother adoption of new work
  • Confidence in system evolution

Related tactics