Pre-built, accessible React components for the GOV.UK Design System.
Build UK government–grade services in React without starting from scratch.
Use it in your app: install from npm, follow the official design patterns, and ship with TypeScript, tests, and live docs.
Tech stack & tooling
The project is built for speed, quality, and maintainability:
- React + TypeScript — type-safe, modern UI.
- Vite — fast dev server and builds.
- Storybook — component development and documentation.
- Vitest — unit tests and coverage (config).
- ESLint (including
eslint-plugin-jsx-a11y) — linting and accessibility rules. - govuk-frontend — official GOV.UK styles as a peer dependency.
Automation & quality
Quality and releases are automated so every change is tested and versioned consistently.
- Chromatic — visual regression on every push via chromatic.yml.
- Unit testing — Vitest and CI run
npm run test:all(lint, tests, build). - Accessibility — Storybook addon-a11y and jsx-a11y in ESLint.
- Changesets — versioning and changelog via .changeset and release flow.
Pipeline integration
All workflows live under .github/workflows:
- lint.yaml — CI on every push (lint, typecheck, unit tests, build).
- publish.yaml — after CI on
main: “Version Packages” PR or npm publish. - deploy-github-pages.yaml — Storybook build and deploy to GitHub Pages.
- chromatic.yml — Chromatic visual testing on every push.
Full details: DEPLOYMENT.md.
Volunteer with us
We’re looking for volunteer contributors to help grow the library: new components, docs, tests, accessibility, and bug fixes. All experience levels welcome — you’ll be credited in the project and release notes.
Leave a Reply