Removing & deprecating components

Context

As our design system evolves, we need to manage the lifecycle of components by deprecating those no longer used and eventually removing them from both the codebase and the figma design system. This helps keep everything current and consistent.

Problem

Deprecated components can linger in the codebase and design system, causing confusion and inconsistencies. We need a clear process for deprecating, removing, and updating components to ensure a smooth transition.

Proposed Solution

Deprecation Process:

  • Design System: Identify and mark components as deprecated in Figma Component Library and Design System Documentation
    1. Codebase: Update, replace or remove uses of a component

Removal Process:

  • Codebase: Delete the component from the codebase once it’s confirmed as not in use.
    1. Design System: Keep deprecated components in Figma for reference, but clearly mark them as deprecated to avoid confusion.

Transitioning Away:

  • Component Library: Stop using deprecated components and switch to updated or alternative components.

This approach ensures that deprecated components are phased out in the Codebase and Design System Documentation keeping our codebase more consistent and preventing use of the components. However it maintains the deprecated components in the Figma component library for reference.