Skip to main content
  1. Home
  2. Apps

Application: side-by-side-browser

Proxy a web site to preview the redirections ahead of it being transitioned to GOV.UK

GitHub
side-by-side-browser
Ownership
#govuk-publishing-platform
Hosting
Heroku
Category
Transition apps
Links

README

Proxy a web site to preview redirections ahead of it being transitioned to GOV.UK.

sketchy explanation

Run the tests

$ npm install
$ npm test

Development

$ node server.js

…then you can use nip.io to make it work with localhost, eg:

http://www.justice.gov.uk.side-by-side.127.0.0.1.nip.io:3023/__/#/

Installation

Run the server on Heroku. It requires a side-by-side wildcard subdomain pointed to it:

$ heroku domains:add *.side-by-side.publishing.service.gov.uk

Follow the returned instructions to CNAME the wildcard to Heroku.

By default, the application will take its list of allowed domains from the production instance of the GOV.UK Transition tool. This can be overridden with the SIDE_BY_SIDE_HOSTS environment variable. Examples:

  • SIDE_BY_SIDE_HOSTS=https://transition.publishing.service.gov.uk/hosts (the default)
  • SIDE_BY_SIDE_HOSTS=file:etc/hosts.json
  • SIDE_BY_SIDE_HOSTS=https://example.com/hosts