Skip to content

First-class way of sharing design specs/artifacts

Currently the GitLab UX department hosts design specs (example) in the Design project, using GitLab Pages to build this index: https://gitlab-org.gitlab.io/gitlab-design. By mentioning the GitLab issue when committing the design specs to that project's repository, a note is created in the issue to let everyone know that the specs are available or have been updated (live example):

image

Some designers also link to the design specs from the issue description, to keep a single source of truth.

While both of these solutions are low tech and low maintenance, they aren't a first-class way of sharing design specs or design artifacts. Issue now have a Designs tab, but it only allows sharing bitmaps, not editable files or design specs.

At GitLab we use a Sketch plugin to generate an HTML file with the design specs, but there are also online tools that generate the specs for you and provide a URL for sharing. Ideally, we should support both approaches.

How can we build a first class way of sharing design specs and design artifacts? Perhaps:

Edited by Pedro Moreira da Silva