{"id":13847544,"url":"https://github.com/alphagov/verify-frontend","last_synced_at":"2025-07-12T11:31:29.228Z","repository":{"id":39458257,"uuid":"51139585","full_name":"alphagov/verify-frontend","owner":"alphagov","description":"The frontend service for GOV.UK Verify","archived":true,"fork":false,"pushed_at":"2023-12-08T17:33:13.000Z","size":7869,"stargazers_count":20,"open_issues_count":0,"forks_count":33,"subscribers_count":49,"default_branch":"master","last_synced_at":"2024-08-05T19:34:25.750Z","etag":null,"topics":["frontend","verify"],"latest_commit_sha":null,"homepage":"","language":"Ruby","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":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2016-02-05T10:13:50.000Z","updated_at":"2024-06-08T03:14:26.000Z","dependencies_parsed_at":"2024-01-15T21:22:00.008Z","dependency_job_id":"303aa8cc-c0aa-42a4-b032-f89c743706e8","html_url":"https://github.com/alphagov/verify-frontend","commit_stats":null,"previous_names":[],"tags_count":2355,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alphagov%2Fverify-frontend","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alphagov%2Fverify-frontend/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alphagov%2Fverify-frontend/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alphagov%2Fverify-frontend/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alphagov","download_url":"https://codeload.github.com/alphagov/verify-frontend/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225820279,"owners_count":17529138,"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":["frontend","verify"],"created_at":"2024-08-04T19:00:20.426Z","updated_at":"2024-11-21T23:30:22.456Z","avatar_url":"https://github.com/alphagov.png","language":"Ruby","funding_links":[],"categories":["User-facing Frontend applications"],"sub_categories":["Department libraries"],"readme":"# verify-frontend\n\n\u003e**GOV.UK Verify has closed**\n\u003e\n\u003eThis repository is out of date and has been archived\n\nThe frontend for GOV.UK Verify\n\n## Installing the application\n\nOnce you’ve cloned this then `bundle` will install the requirements.\n\nAlternatively, build a Docker container with a command such as:\n\n```bash\ndocker build . --network host -t verify-frontend\n```\n\n### Additional prerequisites\n\nIf running on OS X, you'll also need to use [homebrew](https://brew.sh/) to install this dependency:\n\n```bash\nbrew install shared-mime-info\n```\n\n## Running the application\n\n### Standalone\n\nYou can start the application without having any of the closed source components installed with:\n\n`./startup.sh --stub-api`\n\nThis will start the frontend server running on http://localhost:50300/ and a stubbed API server on http://localhost:50199.\n\nTo start a journey on the front end visit http://localhost:50300/test-saml and click `saml-post`.\n\nIf you're on the Verify team and have the rest of the federation running locally you should omit the `--stub-api` argument\nand start your journey from the test-rp.\n\n### With microservices\n\nThe [verify-local-startup](https://github.com/alphagov/verify-local-startup) project allows you to\nbuild and run the Verify Hub and related microservices.\n\nIt makes use of Git, Docker and Ruby to achieve this.\n\n## Running the tests\n\n`./pre-commit-docker.sh` runs tests in a docker container which uses the specified `firefox-esr`\n\nThis will [lint the application code](https://github.com/alphagov/govuk-lint) and run the tests.\n\nIf you need to run the javascript-enabled tests that require a browser, you will need to have Chrome installed. The stable release of Chrome should work.\n\n## Editing .travis.yml\n\nIf you plan to edit this file please enable the pre-commit check which lints it, preventing mistakes.\nTo do so, first install [pre-commit](http://pre-commit.com) and then run `pre-commit install`.\nOn an OSX system this amounts to:\n\n```bash\nbrew install pre-commit\npre-commit install\n```\n\n## Deploying the application\n\nThe application is deployed using our [CI/CD pipeline](https://cd.gds-reliability.engineering/teams/verify/pipelines/deploy-verify-hub?groups=build-apps\u0026groups=default).\nAny changes merged to master are automatically deployed. This repo has an active branch protection for `master`. Any changes need to be raised via PR and approved by two other developers.\n\n## PR reviews\n\nWhen a PR is raised, it's automatically tested using Travis (runs the ./pre-commit.sh script on the branch and against master) which is configured in the [.travis file](/.travis). The test results are shown directly on the PR.\n\nIn addition to the Travis tests we have also enabled Codacy to check coding style. Again, the results are shown within the PR. Codacy is configured using the [.rubocop.yml file](/.rubocop.yml).\n\nThe PR is also deployed to Heroku as [a review app](https://devcenter.heroku.com/articles/github-integration-review-apps). The app is destroyed when the PR is closed/merged or after 5 days of inactivity. It uses docker to run both the Rails app and the stub API server. The Heroku deployment is configured using the 4 files:\n\n* `Dockerfile.heroku` - to configure the docker image of frontend\n* `heroku.yml` - Heroku [deployment manifest](https://devcenter.heroku.com/articles/build-docker-images-heroku-yml)\n* `app.json` - Heroku [application manifest](https://devcenter.heroku.com/articles/app-json-schema)\n* `heroku-startup.sh` - startup script used to start the app and api, on the port supplied by Heroku\n\nTo view or rebuild a Heroku review app [sign into Heroku](https://id.heroku.com/login) using the credentials stored in `verify-blackbox-passwords`. The file inside blackbox is called `heroku-verify-build-bot`. Once logged in it will bring up the dashboard, click on `verify-frontend`. On the left is the column for review apps based on PR's raised and the option under them to open or create a review app.\n\n## Cross GOV.UK Domain Google Analytics\n\nTo track user journeys across the whole of GOV.UK, including Verify, Google Analytics code has been introduced to the Verify Frontend.\n\nWe will occasionally be asked to add domains to the list of domains for which cross domain tracking is enabled. This list is injected through the `CROSS_GOV_GOOGLE_ANALYTICS_DOMAIN_LIST`\nenvironment variable, which is set in the [`verify-infrastructure-config` repository](https://github.com/alphagov/verify-infrastructure-config/blob/master/terraform/deployments/prod/hub/site.tf)\nby setting the `cross_gov_ga_domain_names` variable in the `site.tf` for the relevant environment.\n\n# GOV.UK Design System 3\n\n[GOV.UK frontend](https://github.com/alphagov/govuk-frontend) is included in the repository under\n`lib/node_modules`.  This is installed using `npm`.\nShould you have to update the GOV.UK frontend in the future you'll need to run npm within the lib directory and\ncommit the results. e.g.\n\n```bash\ngit checkout -b \u003csome_branch_name\u003e\ncd ./lib\nnpm update\ngit add .\ngit commit\npush\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falphagov%2Fverify-frontend","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falphagov%2Fverify-frontend","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falphagov%2Fverify-frontend/lists"}