This document outlines the concepts required to write Sass in our design system. Following this document ensures that everyone is writing markup and styling that feels familiar and can be maintained by anyone with little overhead.
- Sass is our preprocessor of choice
- PostCSS for its Autoprefixer plugin
- stylelint is our preferred linter for
SCSS
'. See our custom linting rules - SassDoc is our preferred form of documentation
We strive to write modular, component driven CSS that is reusable and has a clear separation of concerns. We want an accessible codebase that makes it easy for both newcomers and old-hands to understand, navigate, and change features.
Two of the key things to keep in mind when developing are:
- Reusable components first
- Page specific only as a last resort
Continue on to Building a component →