Community

Contribution criteria

The contents of the Design System must be of a high quality and meet user needs. To guarantee this, all components and patterns need to meet certain criteria.

New proposals

To be successful, proposals need to show that the component or pattern being suggested would be useful and unique.

New proposals criteria
Criteria Description
Useful

There is evidence that this component or pattern would be useful for many teams or services.

Evidence could be screenshots or links to versions of it being used in different services.

Unique

It does not replicate something already in the Design System.

If it’s intended to replace an existing component or pattern, there is evidence to show that it’s better than the existing version.

The Design System working group reviews proposals in the community backlog to check they meet these criteria. Proposals that meet the criteria will then be marked ‘to do’, ready to be worked on.

Before a component or pattern is published

The working group reviews the implementation to make sure it is usable, consistent and versatile.

Before publication criteria
Criteria Description
Usable

It has been tested in user research and shown to work with a representative sample of users, including those with disabilities.

Components and patterns which are not proven usable can be published as experimental. But they must be clearly based on relevant user research from other organisations and best practice, and meet the other criteria.

Consistent

It reuses existing styles and components in the Design System where relevant.

Both the guidance and any content included in examples must follow the GOV.UK content style guide.

If there is code, it follows the GOV.UK Frontend coding standards and is ready to merge in GOV.UK Frontend.

Versatile

The implementation is versatile enough that component or pattern can be used in a range of different services that may need it.

For example, a versatile date input component could be set up to ask for a year only, a month and year only, a precise date, or any other combination you may need.

The component or pattern must also have been tested and shown to work with a range of browsers, assistive technologies and devices.

Get in touch

If you’ve got a question, idea or suggestion share it in #govuk-design-system on cross-government Slack (open in app) or email the Design System team on govuk-design-system-support@digital.cabinet-office.gov.uk