Design contributions

Ways to contribute

Whether you have an existing design or requirements for a new feature, the first step is to open a New Feature Request issue. Your request will be reviewed and placed on the PatternFly roadmap. After this, the PatternFly design team will work with you to complete your design proposal and facilitate reviews.

As a designer, here are some of the contributions you can make:

New feature

Work with PatternFly to design a new feature for your product and contribute it back to the system simultaneously.

Example I want to design and contribute a new design pattern for that allows a user to favorite or like an item in a data list.

Enhancement

Improve or update an existing PatternFly 4 component or design pattern.

Example I want to add a compact/expand toggle to the list view.

You may also open an issue to propose a new design guideline page or update an existing guideline, and work with the PatternFly team and stakeholders to author and publish your new content.

Design guideline

Design guidelines appear on the website and help designers to apply PatternFly components in their designs. They are use case and solutions driven.

Example I want to add guidelines for how to apply labels and tags to organize objects.

Design contribution lifecycle

Before you begin the contribution process, follow these guidelines to get your environment setup.

Follow these steps and this template format to submit your designs:

1. Create an issue

2. Propose a design

  • Create a proposal for the new pattern or enhancements (be sure to re-use existing components in the design when applicable)
  • Attach any design assets such as wireframes or mockups to help clarify the design intent and behavior
  • Document all interactions within the desing clearly (you can leverage the PF4 Sketch library in addition to prototyping tools like InVision, Marvel, etc.)

3. Submit your designs

  • The PatternFly team will help you throughout this process. If accepted, you will be assigned a buddy to assist you throughout the rest of the process

Design contribution lifecycle flowchart