Skip to content

Commit 3aa3af7

Browse files
Add changes to v6 page
Co-authored-by: Calvin Lau <calvin.lau@digital.cabinet-office.gov.uk>
1 parent de186e4 commit 3aa3af7

1 file changed

Lines changed: 52 additions & 0 deletions

File tree

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
---
2+
title: Changes to GOV.UK Frontend v6.0.0
3+
weight: 95
4+
---
5+
6+
# Changes to GOV.UK Frontend v6.0.0
7+
8+
The main purpose of v6 include changes to:
9+
10+
- improve our Sass architecture
11+
- 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

Comments
 (0)