Skip to content
GOV.UK Frontend contains the code you need to start building a user interface for government platforms and services.
JavaScript HTML CSS Shell
Branch: master
Clone or download
36degrees Merge pull request #1531 from alphagov/create-issue-template
Add templates for issues and pull requests
Latest commit 5a514ce Aug 12, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Create pull request template Aug 12, 2019
app Fixes "variable is never reassigned. Use const instead." error Jul 23, 2019
bin Add continue prompt to release steps Jan 9, 2019
config Fix tests by updating requires relative directory path Jun 19, 2019
dist Release v3.0.0 Jul 29, 2019
docs Updates the docs refer to 'govuk' namespace Jul 26, 2019
lib
package Release v3.0.0 Jul 29, 2019
src/govuk Merge pull request #1521 from alphagov/simplify-accordion-readme Aug 9, 2019
tasks/gulp Fixes "variable is never reassigned. Use const instead." error Jul 23, 2019
.editorconfig
.gitignore Install SassDoc, add gulp task to build the docs Jun 1, 2018
.nvmrc Update Node.js version to 10.x LTS Feb 8, 2019
.travis.yml Remove npm install optional Feb 8, 2019
CHANGELOG.md Add CHANGELOG entry Aug 1, 2019
CODE_OF_CONDUCT.md Add Code of Conduct file Mar 12, 2018
CONTRIBUTING.md Update CONTRIBUTING.md Jun 13, 2019
LICENSE.txt Add changlog, contributing and license files May 16, 2017
Procfile
README.md Amends from review Jun 21, 2019
app.json Set ENV vars for review apps Jun 26, 2017
gulpfile.js Upgrade to Gulp v4 Apr 17, 2019
jest-puppeteer.config.js Use jest-puppeteer Apr 17, 2019
package-lock.json Add del package as devDependency Jul 31, 2019
package.json Add del package as devDependency Jul 31, 2019
package.json.test.js Update test that checks rollup hasnt changed Feb 8, 2019

README.md

GOV.UK Frontend · Build Status JavaScript Style Guide

GOV.UK Frontend contains the code you need to start building a user interface for government platforms and services.

See live examples of GOV.UK Frontend components, and guidance on when to use them in your service, in the GOV.UK Design System.

Contact the team

GOV.UK Frontend is maintained by a team at Government Digital Service. If you want to know more about GOV.UK Frontend, please email the Design System team or get in touch with them on Slack.

Quick start

There are 2 ways to start using GOV.UK Frontend in your app.

Once installed, you will be able to use the code from the examples in the GOV.UK Design System in your service.

1. Install with npm (recommended)

We recommend installing GOV.UK Frontend using node package manager (npm).

2. Install by using compiled files

You can also download the compiled and minified assets (CSS, JavaScript) from GitHub.

Browser support

GOV.UK Frontend will allow you to build services that comply with the guidance in the Service Manual.

Currently, GOV.UK Frontend officially supports the following browsers:

Operating system Browser Support
Windows Internet Explorer 8-10 functional
Windows Internet Explorer 11 compliant
Windows Edge (latest 2 versions) compliant
Windows Google Chrome (latest 2 versions) compliant
Windows Mozilla Firefox (latest 2 versions) compliant
macOS Safari 9+ compliant
macOS Google Chrome (latest 2 versions) compliant
macOS Mozilla Firefox (latest 2 versions) compliant
iOS Safari for iOS 9.3+ compliant
iOS Google Chrome (latest 2 versions) compliant
Android Google Chrome (latest 2 versions) compliant
Android Samsung Internet (latest 2 versions) compliant

‘Compliant’ means that the components must look as good and function as well as they do in other modern browsers.

'Functional' means the components may not look perfect in the given browser, but must still be usable without errors and without 'looking broken'.

If you are including GOV.UK Frontend as part of a stylesheet that you are generating in your application's build pipeline, you will need to generate and include a separate stylesheet in order to support Internet Explorer 8.

Assistive technology support

GOV.UK Frontend will allow you to build services that comply with the guidance in the Service Manual.

Currently, GOV.UK Frontend officially supports the following assistive technologies:

Software Version Type Browser
JAWS 15 or later screen reader Internet Explorer 11
ZoomText 10.11 or later screen magnifier Internet Explorer 11
Dragon NaturallySpeaking 11 or later speech recognition Internet Explorer 11
NVDA 2016 or later screen reader Firefox (latest versions)
VoiceOver 7.0 or later screen reader Safari on iOS10 and OS X

In addition, we test that all content is accessible with keyboard only.

We aim to support users who adjust or override the colours of websites they visit. We test this by changing colours in Firefox, by enabling 'High Contrast' mode in Windows and by using the High Contrast plugin for Chrome.

Getting updates

To be notified when there’s a new release, you can either:

Find out how to update with npm.

Licence

Unless stated otherwise, the codebase is released under the MIT License. This covers both the codebase and any sample code in the documentation. The documentation is © Crown copyright and available under the terms of the Open Government 3.0 licence.

Contribution guidelines

If you want to help us build GOV.UK Frontend, view our contribution guidelines.

You can’t perform that action at this time.