This document describes various guidelines to ensure consistency and quality across GitLab's frontend team.
GitLab is built on top of Ruby on Rails using Haml and also a JavaScript based Frontend with Vue.js. Be wary of the limitations that come with using Hamlit. We also use SCSS and plain JavaScript with modern ECMAScript standards supported through Babel and ES module support through webpack.
Working with our frontend assets requires Node (v8.10.0 or greater) and Yarn (v1.10.0 or greater). You can find information on how to install these on our installation guide.
For our currently-supported browsers, see our requirements.
Current high-level frontend goals are listed on Frontend Epics.
High-level guidelines for contributing to GitLab.
How we plan and execute the work on the frontend.
How we go about making fundamental design decisions in GitLab's frontend team or make changes to our frontend development guidelines.
How we write frontend tests, run the GitLab test suite, and debug test related issues.
Common JavaScript design patterns in GitLab's codebase.
Vue specific design patterns and practices.
Vuex specific design patterns and practices.
Axios specific practices and gotchas.
How to use GraphQL
How we use SVG for our Icons and Illustrations.
How we use UI components.
How we use Snowplow to track custom events.
Read the frontend's FAQ for common small pieces of helpful information.
We use eslint to enforce our JavaScript style guides. Our guide is based on the excellent Airbnb style guide with a few small changes.
Our SCSS conventions which are enforced through scss-lint.
Best practices for monitoring and maximizing frontend performance.
Frontend security practices.
Our accessibility standards and resources.
Frontend internationalization support is described in this document. The externalization part of the guide explains the helpers/methods available.