Engineering

Once the design assets are finalised and reviewed, you’re ready to start an engineering contribution to the design system. If creating or modifying an existing component, follow the steps below:

  1. Talk to your designer: in many cases, engineering contributions rely on on design work. Ensure the design phase is completed and go through the hand-over process. This may include a Component Discovery session.
  2. Implement changes and associated story: build the designs and accompanying Component Showcase story. You can refer to the Frontend Getting Started Guide for advice on general front end patterns and approaches, such as Styling, Routing, State Management, etc.
  3. Test accordingly to Definition of Ready: ensure that the changes conform to Engineer Definition of Ready.
  4. Open a Pull Request: submit a draft PR, mark as “ready for review” when all checks have passed, and request review from your team. You can also reach out to in the #team-frontend-foundations-requests channel for feedback.
  5. Create (or edit) design system documentation: after your PR is accepted, use the [Template] Component in Supernova Code section as a guideline to document where the component can be found and its props. When proposing documentation changes, follow making and publishing changes guidelines.
  6. Merge: Merge the pull request in GitHub, this will automatically publish the Design System Component Library package.