Design Pattern Library - Add icons

Ensure all icons have been uploaded to the brand.ai library

Example(s)

(Image of the pattern you are adding to the library)

abuse.svg account.svg angle-down.svg angle-left.svg angle-right.svg angle-up.svg appearance.svg applications.svg approval.svg arrow-down.svg
arrow-right.svg assignee.svg bold.svg book.svg branch.svg bullhorn.svg cancel.svg calendar.svg chart.svg clock.svg
earth.svg ellipsis.svg epic.svg external-link.svg eye-slash.svg eye.svg file-additions.svg file-deletion.svg file-modified.svg filter.svg
folder.svg fork.svg code.svg collapse-left.svg comment-dots.svg collapse-right.svg comment-next.svg comment.svg comments.svg commit.svg
credit-card.svg cut.svg disk.svg doc-code.svg doc-image.svg doc-text.svg download.svg duplicate.svg group.svg git-merge.svg
history.svg hook.svg home.svg hourglass.svg issue-block.svg import.svg issue-child.svg issue-close.svg issue-duplicate.svg issue-external.svg
issue-open.svg issue-parent.svg issues.svg job-cancelled.svg key-modern.svg key.svg labels.svg leave.svg level-up.svg license.svg
link.svg list-bulleted.svg list-numbered.svg location-dot.svg location.svg lock-open.svg lock.svg log.svg mail.svg menu.svg
merge-request-close-m.svg merge-request-close.svg mobile-issue-close.svg monitor.svg more.svg notifications-off.svg notifications.svg overview.svg pencil.svg pipeline.svg
play.svg plus-square-o.svg plus-square.svg plus.svg podcast.svg preferences.svg profile.svg push-rules.svg question-o.svg question.svg
quote.svg redo.svg remove.svg repeat.svg retry.svg rss.svg scale.svg screen-full.svg screen-normal.svg search.svg
settings.svg shield.svg slight-frown.svg slight-smile.svg smile.svg smiley.svg spam.svg snippets.svg star-o.svg
star.svg status_canceled_borderless.svg status_created_borderless.svg status_failed_borderless.svg status_manual_borderless.svg status_notfound_borderless_refactored.svg status_pending_borderless.svg status_running_borderless.svg status_skipped_borderless.svg status_success_borderless.svg
stop.svg tachometer.svg talic.svg task-done.svg template.svg terminal.svg thumbtack.svg thump-down.svg thump-up.svg timer.svg
todo-add.svg todo-done.svg token.svg unapproval.svg unassignee.svg unlink.svg user.svg users.svg volume-up.svg warning.svg
work.svg wrench.svg

Usage

(When do you use this pattern? And how? This is being collected for design.gitlab)

Icons are used to stress the visual weight for the elements with the high priority on a screen or to explain the universal knowledge in a simple way.

The level of visual weight from heavy to light is: Icon + label > Icon > label.

The size of icons(#102 (closed)):

  • Bounding box: 16x16px
  • Live area:
  • Height: 14px
  • Width: 14px (If the icon like commit is wide but short, the recommended width is 16px)
  • Make sure the icons balance the visual weight in the particular usage.

The detail measurement of icons:

Grid Stroke
grids stroke
Corner Margin
corner space

Dos and Dont's

(Use this table to add images and text describing what’s ok and not ok. This is being collected for design.gitlab)

  • Don't use an icon to refer to different meanings.
  • Don't use different icons to refer to a specific meaning.
Don't frequently use the combination of an icon and a label.
  • Using the combination only for the elements with high priority. For instance, we only use a icon + a label for the contextual navigation.
Do 🛑 Don’t
01-do-icon-and-label 01-dont-icon-and-label
Don't use an icon to explain a meaning which is not straight-forward.
  • If it is inevitable, providing a quick explanation for users in a tooltip.
Do 🛑 Don’t
02-do-with-tooltip 02-dont-without-tooltip
Using the whole pixel for creating icons to align to measurement correctly
Do 🛑 Don’t
pixel-perfect pixel-not-perfect
Using rounded strokes
Do 🛑 Don’t
05-do-rounded-corner 05-dont-sharp-corner
Simplify icons for clarity and legibility
Do 🛑 Don’t
03-do-simple 03-dont-complexity
Make the icons front-face instead of different dimensions.
Do 🛑 Don’t
04-do-plain 04-dont-dimensional

Related patterns

Links / references

Pattern checklist

Make sure these are completed before closing the issue, with a link to the relevant commit, if applicable.

  1. Ensure that you have broken things down into atoms, molecules, and organisms.
  2. Check that you have not created a duplicate of an existing pattern.
  3. Ensure that you have used the proper method for creating the pattern depending on the complexity. Atoms and molecules are symbols, organisms are groups.
  4. Make sure that text is created using text styles. When applicable used shared styles for colors.
  5. QA check by another UX'r (create and reference a file in this issue which includes the changes as you would like to add them to the gitlab-elements file)
Edited by Hazel Yang