{"id":13631180,"url":"https://github.com/alphagov/govuk-design-system","last_synced_at":"2025-05-08T22:49:56.178Z","repository":{"id":37742862,"uuid":"93611204","full_name":"alphagov/govuk-design-system","owner":"alphagov","description":"One place for service teams to find styles, components and patterns for designing government services.","archived":false,"fork":false,"pushed_at":"2025-05-08T17:34:41.000Z","size":31731,"stargazers_count":547,"open_issues_count":366,"forks_count":252,"subscribers_count":32,"default_branch":"main","last_synced_at":"2025-05-08T22:49:50.631Z","etag":null,"topics":["design-systems","government","govuk-design-system","govuk-design-system-team","portfolio"],"latest_commit_sha":null,"homepage":"https://www.gov.uk/design-system","language":"Nunjucks","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alphagov.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/contributing/adding-images-to-the-wesite.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-06-07T08:27:16.000Z","updated_at":"2025-05-06T18:51:39.000Z","dependencies_parsed_at":"2024-04-15T10:30:16.789Z","dependency_job_id":"b30ff62b-5728-4ffc-8dd4-8262c9e428ed","html_url":"https://github.com/alphagov/govuk-design-system","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alphagov%2Fgovuk-design-system","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alphagov%2Fgovuk-design-system/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alphagov%2Fgovuk-design-system/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alphagov%2Fgovuk-design-system/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alphagov","download_url":"https://codeload.github.com/alphagov/govuk-design-system/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253160827,"owners_count":21863624,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["design-systems","government","govuk-design-system","govuk-design-system-team","portfolio"],"created_at":"2024-08-01T22:02:14.131Z","updated_at":"2025-05-08T22:49:56.157Z","avatar_url":"https://github.com/alphagov.png","language":"Nunjucks","funding_links":[],"categories":["Nunjucks","Core libraries"],"sub_categories":[],"readme":"# GOV.UK Design System\n\nThis repository contains the code for the GOV.UK Design System website. To find the code we provide for reuse by services, go to the [govuk-frontend repository](https://github.com/alphagov/govuk-frontend).\n\n## Run locally\n\nYou'll need [Git](https://help.github.com/articles/set-up-git/) and [Node.js](https://nodejs.org/en/) installed to get this project running.\n\nNote: You will need the [active LTS (Long-term support)](https://github.com/nodejs/Release#release-schedule) Node.js version for this project (as specified in [.nvmrc](./.nvmrc))\n\n### Fork repository (optional)\n\nIf you're an external contributor make sure to [fork this project first](https://help.github.com/articles/fork-a-repo/)\n\n### Clone repository\n\n```shell\ngit clone git@github.com:alphagov/govuk-design-system.git # or clone your own fork\n\ncd govuk-design-system\n```\n\n### Using nvm (optional)\n\nIf you work across multiple Node.js projects there's a good chance they require different Node.js and npm versions.\n\nTo enable this we use [nvm (Node Version Manager)](https://github.com/creationix/nvm) to switch between versions easily.\n\n1. [install nvm](https://github.com/creationix/nvm#installation)\n2. Run `nvm install` in the project directory (this will use [.nvmrc](./.nvmrc))\n\n### Install npm dependencies\n\n```shell\nnpm install\n```\n\n### Start a local server\n\nThis will build sources, serve pages and watch for changes.\n\n```shell\nnpm start\n```\n\n## Build\n\nBuild `./src` to `./build`\n\n```shell\nnpm run build\n```\n\n## Run the Sass linter\n\nWe are using the tool [stylelint][stylelint] to lint the Sass files in\n`source/stylesheets`. You can run the linter from command line by running:\n\n```shell\nnpm run lint\n```\n\n[stylelint]: https://github.com/stylelint/stylelint\n\n## GOV.UK Frontend packages\n\nDesign System consumes the [GOV.UK Frontend](https://github.com/alphagov/govuk-frontend) package via [NPM](https://www.npmjs.com/).\nThis is defined in the [package.json](package.json) file.\n\n---\n\n## Continuous integration\n\nWhen changes are pushed to GitHub, [Github Actions][github-actions] will:\n\n- run the tests\n- lint the Sass stylesheets in `source/stylesheets`\n- run the `npm run build` command to ensure that the site can be generated\n\nIf any of these fail, this will be reported in the GitHub status checks\ninterface.\n\n[github-actions]: https://github.com/alphagov/govuk-design-system/actions\n\n## Deployment\n\n- [How the Design System is deployed to production](docs/deployment.md#production)\n- [How branch and PR previews are deployed](docs/deployment.md#pull-request-previews)\n\n## Security\n\nGDS is an advocate of responsible vulnerability disclosure. If you’ve found a vulnerability, we would like to know so we can fix it.\n\nTo learn how to report a security vulnerability, [see our security policy](https://github.com/alphagov/govuk-design-system/security/policy).\n\n## Contributing\n\nThe govuk-design-system repository is public and we welcome contributions from anyone.\n\nContributors to alphagov repositories are expected to follow the [Contributor Covenant Code of Conduct](https://github.com/alphagov/.github/blob/main/CODE_OF_CONDUCT.md#contributor-covenant-code-of-conduct). Contributors working within government are also expected to follow the [Civil Service code](https://www.gov.uk/government/publications/civil-service-code/the-civil-service-code).\n\nWe're unable to monitor activity on this repository outside of our office hours (10am to 4pm, UK time). To get a faster response at other times, you can [report abuse or spam to GitHub](https://docs.github.com/en/communities/maintaining-your-safety-on-github/reporting-abuse-or-spam).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falphagov%2Fgovuk-design-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falphagov%2Fgovuk-design-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falphagov%2Fgovuk-design-system/lists"}