Proxy a web site to preview the redirections ahead of it being transitioned to GOV.UK
Clone or download
Latest commit 228615f Nov 7, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
public Use SRI Nov 1, 2018
test
.gitignore Ignore node_modules directory Jul 20, 2012
LICENCE
Procfile Add Procfile for govuk_spinup Jul 20, 2012
README.md Update xip.io to nip.io Sep 26, 2018
allowlist.js
explorer.js Add simple error catching Feb 18, 2014
hostname.js
jenkins.sh
package.json
proxy.js
server.js Rename whitelist to allowlist Aug 23, 2017

README.md

Side-by-side browser

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