Install

GOV UI ships a plain stylesheet and a UMD script. Neither requires a bundler, because many of the projects this system targets do not have one.

Plain HTML

The primary path. Two tags, no build step:

<link rel="stylesheet" href="gov-ui.css">
<script src="gov-ui.js" defer></script>

<button class="gov-button gov-button--primary gov-button--md" type="button">Save</button>

Components initialize themselves from data-gov-module attributes. There is no wiring code to write.

React

npm install @gov-ui/react @gov-ui/css

import { Button } from "@gov-ui/react";

export function SaveAction() {
  return <Button>Save</Button>;
}

Server-rendered frameworks

Adapters emit exactly the markup in the plain-HTML example. They carry no styles and no behavior of their own — anything else in an adapter is a bug.

<!-- .NET Razor -->
<gov-button variant="primary">Save</gov-button>

<!-- Django -->
{% gov_button variant="primary" %}Save{% endgov_button %}

<!-- Laravel Blade -->
<x-gov-button variant="primary">Save</x-gov-button>

Support tiers

Published so expectations are honest. Five ecosystems is real maintenance surface, and implying that all of them get equal attention would be a promise this project cannot keep.