Get started

The examples in the GOV.UK Design System come with code to make it easy for you to use them in your project.

There are guides to getting started:

You may find the guide on updating your code useful if you’re working with one of our legacy products - GOV.UK Elements, GOV.UK Template or the GOV.UK Frontend Toolkit.

Using styles, components and patterns

When something is published in the GOV.UK design system as a style, component or pattern we include details of how and when it’s been tested in user research. This should help you decide whether it’s something you can use or adapt for your service.

You can ask questions or share your research by joining the discussion on GitHub. There are links at the end of each style, component and pattern page - under the ‘Help improve this page’ heading.

GitHub discussions about styles, components and patterns

Bear in mind that ideas discussed on GitHub may not have been tested. You can use them as a starting point, but it’s important to carry out user research to check that they work for your service. Then when you’ve carried out your user research, add your findings to the relevant discussion.

GitHub discussions are open to everyone, including members of the public. The views expressed there are the views of individuals and not the views of the GOV.UK Design System team.