Pay Product Page

Running Locally

• bundle install to install middleman and its dependencies
• npm install to install the frontend dependencies
• bundle exec middleman server - to start middleman's built in server
• open http://localhost:4567 - to open the example in your browser

Building a Static Copy of the Site

• bundle install
• npm install
• bundle exec middleman build

Check the build directory for the output.

Components

Look at the CSS for the individual components for usage examples and notes.

• Breadcrumbs
• Content Section
• Full Width Form
• GOV.UK Logo
• Header
• Hero 'Alternative Action'
• Hero Button
• Masthead
• Phase Banner
• Related Items
• Skip Link
• Sub Navigation

Releasing a Static Copy of the Site

Use the command line script github-release to build an artifact containing the generated static site which is published as a GitHub release.

1. Checkout and pull the master branch
2. Follow the instructions above under Building a static copy of the site
3. Generate a personal access token in GitHub. The token should have the repo scope.
4. Run the following:

GITHUB_TOKEN=xxx bin/github-release --version 1.0.1 publish

• GITHUB_TOKEN is the personal access token you generated
• the --version argument specifies the version of the new release (pick something sensible based on the previous releases)

The product page is deployed as part of pay-frontend.

1. Update the pay-product-page dependency in the package.json file in pay-frontend to point to the GitHub URL for the .tgz file associated with the GitHub release.
2. Within pay-frontend, run npm install.
3. Merge and deploy the changes to pay-frontend.

Licence

MIT Licence

Vulnerability Disclosure

GOV.UK Pay aims to stay secure for everyone. If you are a security researcher and have discovered a security vulnerability in this code, we appreciate your help in disclosing it to us in a responsible manner. Please refer to our vulnerability disclosure policy and our security.txt file for details.