You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
- use an updated type scale to improve accessibility for small screens
12
+
- update colours to use the web palette in the GOV.UK brand guidelines
13
+
- improve the page template layout
14
+
15
+
We’ve also removed a number of deprecated APIs, Sass variables and component options.
16
+
17
+
## Migrating from v5 to v6
18
+
19
+
Follow the guidance about [staying up to date with GOV.UK Frontend](https://frontend.design-system.service.gov.uk/staying-up-to-date/).
20
+
21
+
When making the decision to migrate, consider your service's requirements and your ability to update Sass tooling and templates. In particular, you must update to [Dart Sass v1.79.0 or newer](https://sass-lang.com/dart-sass/) before upgrading to v6.
22
+
23
+
## Benefits of updating to v6
24
+
25
+
By updating to v6 you'll:
26
+
27
+
- stay aligned with the GOV.UK look and feel: we've updated GOV.UK Frontend to use the web colour palette from the GOV.UK Brand Guidelines
28
+
- benefit from a more consistent colour system that's used in certain components
29
+
- get the latest accessibility improvements, based on ongoing testing and feedback from services across government
30
+
- benefit from a smaller CSS payload
31
+
- be able to customise the page template further than before
32
+
33
+
## Updating to v6
34
+
35
+
Read the [GOV.UK Frontend v6.0.0 release notes](https://github.com/alphagov/govuk-frontend/releases/v6.0.0).
36
+
37
+
There are actions you must make to migrate to v6.0.0. These are items you need to update, check or remove.
38
+
39
+
You might need to update some items, including:
40
+
41
+
- your Sass compiler to [Dart Sass v1.79.0 or newer](https://sass-lang.com/dart-sass/)
42
+
- using the new GOV.UK web palette
43
+
- using the new colour functions, and replacing colours to follow the new naming convention
44
+
45
+
You'll need to check some items still work as expected, which include:
46
+
47
+
- your service’s custom colours for contrast and legibility with the new web palette
48
+
- any custom components that reference functional colours or CSS custom properties
49
+
- any custom header or footer content if you now include Service navigation or Phase banner components within the `<header>` element
50
+
- testing the new type scale in your service to see if you need to make any adjustments, such as spacing or positioning values
51
+
52
+
You'll also need to remove references to any APIs, Sass variables and component options we've that removed.
0 commit comments