has been released! Read the upgrade guide


Brand new guidance

We strongly encourage our community to follow this guidance. It’s not mandatory yet, but it will become part of the MOD Service Assessments in due time. Questions? Contact your friendly MOD Design System team:

We publish a collection of companion packages to help you build robust web applications.

1NPM Packages

The MOD.UK Design System monorepo consists of a collection of NPM packages:


We adhere to semantic versioning across the monorepo as a whole.

This means that you should always match package versions, when using combinations of @defencedigital/* packages.


We generate and publish nightly stable builds of all packages. All packages are published to the NPM registry.

4Contributing & issues

If you would like to make a contribution or raise an issue with the MOD.UK Design System, you can do so on GitHub.

Please refer to our contributing guidelines before you make your contribution.


If you have recently updated then read the release notes.


The Design System Roadmap Board offers an overview of prioritised work for the next 12 months.


All packages are licensed under the Apache License 2.0 unless otherwise stated.


The MOD.UK Design System provides guidance and tools for building high–quality Services within the UK Ministry of Defence. This project is open source and its source code is available on GitHub.

All content is available under the Apache 2.0 licence, except where otherwise stated.

© Crown copyright