Back to Instructables

Design System Contribution Guide

A process for proposing, designing, and adding new components or patterns to the design system.

Why Contribute?

A design system is a living product that evolves with the needs of the team and the product. Contributions from designers and developers ensure the system stays relevant, comprehensive, and useful for everyone.

The Contribution Process

  1. Identify a Need

    Have you designed a UI pattern that is being reused in multiple places but doesn't exist in the system? This is a great candidate for a new component.

  2. Propose the Component

    Create a proposal ticket (e.g., in Jira or GitHub). Include screenshots of where the pattern is used, why it's needed, and any initial design thoughts.

  3. Design & Review

    Design the component in its various states (default, hover, active, disabled, error, etc.). Get feedback from the design system team and other designers.

  4. Build & Document

    Once the design is approved, a developer builds the component. The designer is responsible for writing clear documentation on how and when to use it.

  5. Release & Announce

    The new component is added to the design system library and announced to the wider team (e.g., in a Slack channel or newsletter).