2020-10-30 14:08:56 -04:00
---
stage: none
group: unassigned
2020-11-26 01:09:20 -05:00
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
2020-10-30 14:08:56 -04:00
---
2020-03-02 10:08:01 -05:00
# Frontend dependencies
2021-02-10 13:09:02 -05:00
We use [yarn@1 ](https://classic.yarnpkg.com/lang/en/ ) to manage frontend dependencies.
2020-03-02 10:08:01 -05:00
2021-02-10 13:09:02 -05:00
There are a few exceptions in the GitLab repository, stored in `vendor/assets/` .
2020-03-02 10:08:01 -05:00
2021-02-10 13:09:02 -05:00
## What are production and development dependencies?
These dependencies are defined in two groups within `package.json` , `dependencies` and `devDependencies` .
For our purposes, we consider anything that is required to compile our production assets a "production" dependency.
That is, anything required to run the `webpack` script with `NODE_ENV=production` .
Tools like `eslint` , `jest` , and various plugins and tools used in development are considered `devDependencies` .
This distinction is used by omnibus to determine which dependencies it requires when building GitLab.
2020-03-02 10:08:01 -05:00
2021-02-10 13:09:02 -05:00
Exceptions are made for some tools that we require in the
`compile-production-assets` CI job such as `webpack-bundle-analyzer` to analyze our
2021-03-08 10:08:54 -05:00
production assets post-compile.
2021-02-10 13:09:02 -05:00
## Updating dependencies
2020-03-02 10:08:01 -05:00
2021-07-31 05:08:41 -04:00
See the main [Dependencies ](../dependencies.md ) page for general information about dependency updates.
2020-03-02 10:08:01 -05:00
### Blocked dependencies
2021-02-10 13:09:02 -05:00
We discourage installing some dependencies in [GitLab repository ](https://gitlab.com/gitlab-org/gitlab ) because they can create conflicts in the dependency tree.
Blocked dependencies are declared in the `blockDependencies` property of the GitLab [`package.json` ](https://gitlab.com/gitlab-org/gitlab/-/blob/master/package.json ).
2020-03-02 10:08:01 -05:00
## Dependency notes
### BootstrapVue
2020-06-04 17:08:11 -04:00
[BootstrapVue ](https://bootstrap-vue.org/ ) is a component library built with Vue.js and Bootstrap.
2020-03-02 10:08:01 -05:00
We wrap BootstrapVue components in [GitLab UI ](https://gitlab.com/gitlab-org/gitlab-ui/ ) with the
purpose of applying visual styles and usage guidelines specified in the
[Pajamas Design System ](https://design.gitlab.com/ ). For this reason, we recommend not installing
BootstrapVue directly in the GitLab repository. Instead create a wrapper of the BootstrapVue
component you want to use in GitLab UI first.
