GOV.UK Vue is a Vue 3 component library for GOV.UK Frontend. It enables you to build Vue apps based on the GOV.UK Design System.

You can use GOV.UK Vue to build easy-to-use, accessible apps whether you're working on a government service or not.

GOV.UK Vue is currently in alpha, so things may change between now and the first stable release - please share any feedback by starting a discussion or raise an issue for any problems.

See a minimal example of a GOV.UK-style page using this library.

The source for this demo is available in the govuk-vue-minimal-example repo.

govukvue.org has detailed instructions on how to install GOV.UK Vue, including how to use GOV.UK Vue with Nuxt.

There's also detailed documentation and examples for every component.

If you need any help getting set up, get in touch.

GOV.UK Vue aims to provide all of the GOV.UK Frontend components as Vue components.

In almost all cases GOV.UK Vue provides every option available in the original Nunjucks templates and outputs the same HTML (though there are some differences).

Styling is entirely provided by GOV.UK Frontend. GOV.UK Vue does not reimplement any of the Frontend styling, or provide any of its own.

Accessibility is the #1 priority of GOV.UK Vue. It provides full support for all accessibility features in GOV.UK Frontend, and any accessibility issues will be given priority over new features.

All JavaScript functionality from GOV.UK Frontend, such as accordions and character counts, is reimplemented in TypeScript within individual Vue components. No JavaScript files from GOV.UK Frontend are used. No external dependencies are used in components beyond Vue.

This project is licenced under the MIT License. An acknowledgement in your README.md is appreciated but not necessary.

Even if you don't need any help, I'd love to know what you're using GOV.UK Vue for - please get in touch if you use it.

GOV.UK Vue is built and maintained by Matt Eason as a community resource. It's not maintained or supported by GDS.

If you find this project useful, I'd really appreciate your support through Ko-fi or GitHub Sponsors.