Skip to main content

Guidelines and Decisions

Overview

This document serves as a guide and a record for conventions that we have agreed to implement as a team (including Product, Design and Frontend). This means that we have a shared point of reference for the expectations and implementation of the Design System, and can ensure consistency as we progress through the project.

Relative CSS Units

We will use 8px as the base unit in Storybook. Any measurements above 8px must be defined in the designs using a multiplier that is a whole number or 0.5 (e.g 16px = 2 x 8px, 44px = 5.5 x 8px). If a measurement is less than 8px we will allow multiples of 0.25, 0.5 and 0.75 but only when the measurement is less than 8px (e.g 6px = 0.75 x 8px). This will allow more flexibility from a design point of view for the finer details in designs, whilst maintaining the consistency that comes with using a base unit. It will also prevent a huge code change from a dev perspective, and a revision of lots of hard work to this point.