Design tokens > Token implementation
- Standalone project
- gitlab-ui
- design.gitlab.com
Standalone project
graph TD
Root[design-tokens]
Root --> GitLabUI([gitlab-ui])
Root --> DesignSystem([design.gitlab.com])
Root --> GitLabCom([gitlab-org/gitlab])
Pros:
- Isolated semver versioning
- Projects can have different versions
Cons:
- Another project to maintain
gitlab-ui
graph TD
Root[design-tokens]
Root --> GitLabUI([gitlab-ui])
GitLabUI --> DesignSystem([design.gitlab.com])
GitLabUI --> GitLabCom([gitlab-org/gitlab])
Pros:
- Close to component usage
- Close to SCSS utility classes
- Leverage conventional commits
- Coupled with gitlab-ui version
Cons:
- Coupled with gitlab-ui version
design.gitlab.com
graph TD
Root[design-tokens]
Root --> DesignSystem([design.gitlab.com])
DesignSystem --> GitLabUI([gitlab-ui])
DesignSystem --> GitLabCom([gitlab-org/gitlab])
Pros:
- Close to design docs for documenting/rendering tokens
- Could have potential Figma automation etc.
- Leverage conventional commits
Cons:
- gitlab-ui/gitlab.com don't consume design.gitlab.com
Edited by Scott de Jonge