patternfly / patternfly-design-kit

The PatternFly Design Kit is a Sketch library used for creating PatternFly accurate design mockups
49 stars 39 forks source link

PatternFly Design Kit

The PatternFly Design Kit is a collection of Sketch assets that make it easy for designers to create low and high-fidelity design mockups that accurately represent PatternFly components and layouts. It includes:

Updating the kit

Sketch will automatically receive library updates in the top, right corner of an open Sketch file. You'll want to update the PatternFly library and update the symbols within your file (two separate notifications). You'll have to update all files that are using PatternFly symbols - it is not a one and done process, unfortunately.

To update you PatternFly Template file, open the updated template from your local repo and select File > Save as Template... This will replace the current template with the updated version and make the latest layouts available using the New from Template... feature.

Filing bugs

If something isn't working as expected with the library or template file, please file an issue in this repo and label it with "bug". We should be able to fix it within a couple days! If something is wrong with the Wireframe kit, please contact Alessandro Contini acontini@redhat or file an issue in this repo.

Contributing to the PatternFly Design Kit

We welcome contributions from our community of PatternFly designers. Please contact Lucia Boehling (@lboehling) on the #patternfly-design-kit channel within the patternfly.slack.com Slack workspace.

Contributing a new or edited symbol

Follow these steps:

  1. Download the library file from here.
  2. Create new symbols or edit symbols using the styles and elements from "Document". Be sure you take them from "Document" rather than "PatternFly"
  3. When naming a new symbol, follow the naming mechanism within that same category (e.g., Forms / 2. Text Box / Success).
  4. Make it clear which page in the file you edited and which symbols on the page you added/edited by adding a ⭐️ or some other mark to call them out.
  5. Zip your file and attach it to the GitHub issue you were assigned to. Add a list of the symbols you added/edited and, finally, tag @lboehling in your comment.

    Contributing a new or edited template

    Follow these steps:

  6. Download the template file hosted on Sketch Cloud from here.
  7. If the template you're working on fits within an existing page, create a new artboard and add it to that page. If it doesn't fit into an existing page, create a new page and then add artboards from there.
  8. Be sure to add all padding specific to that example in it's own folder within the layer list called "📐Padding" and hide it.
  9. If the design variation is new and needs a spec, add it to the first artboard, add it's name (use the comment text style), and unhide the "📐Padding" group (see the template file for existing examples of how this is done now).
  10. Zip your file and attach it to the GitHub issue you were assigned to. Add a list of pages you added/edited and the artboards on those pages. Finally, tag @lboehling in your comment.

    Questions?

    If you have any questions or concerns, please contact Lucia Boehling lboehlin@redhat.com.