![Banner](/public/assets/images/README.png)

[GOV.UK but it's personal project README]: # 

![GitHub last commit](https://img.shields.io/github/last-commit/leowilkin/govuk-personal)
![NPM Downloads](https://img.shields.io/npm/dw/create-govuk-personal)
![NPM License](https://img.shields.io/npm/l/create-govuk-personal)
![Website](https://img.shields.io/website?url=https%3A%2F%2Fgovuk.wilkin.xyz)
![GitHub Repo stars](https://img.shields.io/github/stars/leowilkin/govuk-personal)

## The Pitch

Are you a well-seasoned open-sourcerer and love the work that the UK Gov Digital Services do?

Are you also like me and have a bit of a _thing_ for the GOV.UK Design System?

The only sane solution would be to turn GDS's production Design System kit into a personal website.

## Quick Start

```bash
npm create govuk-personal@latest
cd my-govuk-site
npm run dev
```

See more information here: [govuk.wilkin.xyz](https://govuk.wilkin.xyz/quickstart/).

## Why it can't look exactly like GOV.UK

> If your service is not on a service.gov.uk domain, you cannot use the GOV.UK crown logo.

This template uses a custom logo placeholder.

> You also will not be able to use the New Transport font. Use the Helvetica or Arial CSS font stacks instead.

GDS Transport has been substituted for Helvetica.

[Source: gov.uk](https://www.gov.uk/service-manual/design/services-for-government-users)

## Documentation

Visit the [documentation](https://github.com/leowilkin/govuk-personal/blob/main/docs/components.md) for detailed guides on using the components on your site.

## The Legal Bits

This project is not affiliated by GDS, or the UK Govt. in any shape or form. I do love GDS though, so show them some love on their GitHub: [@alphagov](https://github.com/alphagov).

This work remains under the MIT License, with modifications attributable to [@leowilkin](https://github.com/leowilkin). View the licence [here](https://github.com/leowilkin/govuk-personal/blob/main/LICENSE).

## The Footnote

This project was made for The Journey v2, a project at [Hack Club](https://hackclub.com). It's been a whirlwind of fun, I've spent nearly 9 hours working on this with a supportive Slack community helping me debug bits. Despite working for the end goal of shipping this (I HAVE!), it's been a lot of personal development, and a lot of fun!

~ Leo, Jun 6th 2025