Gitlab hero border pattern left svg Gitlab hero border pattern right svg

Contributing to UX Design

UX Design

These instructions are specifically for those wanting to contribute UX designs.

The UX department at GitLab uses Figma for all of its designs, and you can see our Design Repository documentation for details on working with our files.

Also, visit our Contributing guidelines for general guidance on contributing. While they are code-focused instructions, they will help you understand the overall process of contributing.

  1. You may leverage the Pajamas UI Kit in Figma to create mockups for your proposals.
  2. You do not need to use Figma to contribute. We will gladly accept handmade drawings and sketches, wireframes, manipulated DOM screenshots, prototypes, and so on.
  3. You can find design pattern documentation in our Design System. Use it to understand where and when to use common design solutions.
  4. If you don't already have an idea for a UX improvement, you can pick an existing problem to work on from this list of issues looking for community contributions
  5. Be sure to comment and verify that no one else is working on the UX for the issue, and to make sure we’re still interested in a given contribution.
  6. Ask questions to clarify the problem being solved and make your UX suggestions using words, low-fi wireframes, hi-fi designs, or even prototypes. Ask for help if you’re new or if you get stuck. We’re happy to help! You can ping the UX Department in an issue or comment using this handle @gitlab-com/gitlab-ux.
  7. Ask for a review from a GitLab Product Designer. You’ll likely need to change some things once the reviewer has completed their review. You may also require multiple reviews depending on the scope of the UX.
  8. Get your UX approved!
GIT is a trademark of Software Freedom Conservancy and our use of 'GitLab' is under license