Chrome and Firefox extension for developers working on GOV.UK.
JavaScript CSS HTML Ruby
Clone or download
Latest commit 4c5c15c Jun 21, 2018
Permalink
Failed to load latest commit information.
build Release 1.11.2 Mar 6, 2018
docs Update screenshot Jan 12, 2018
spec/javascripts Speculatively link to Design System for `govuk-` components Jun 20, 2018
src Speculatively link to Design System for `govuk-` components Jun 20, 2018
.gitignore Release version 1.6.0 Jan 17, 2017
.ruby-version Update Ruby and Jasmine versions Jan 24, 2018
Gemfile Update Ruby and Jasmine versions Jan 24, 2018
Gemfile.lock
README.md Update repo name Mar 6, 2018
Rakefile Update repo name Mar 6, 2018
circle.yml

README.md

GOV.UK Toolkit for Chrome and Firefox

Allows easy switching between the different GOV.UK environments and content representations. Inspired by the govuk-bookmarklets.

Screenshot

Installation

The extension is downloadable on the Chrome web store and AMO for Firefox.

If you don't want to install from your browser's web store for security reasons, you can install a local non-self updating copy.

For Chrome:

  1. Download the source from GitHub and unzip.
  2. Visit chrome://extensions in your browser.
  3. Ensure that the Developer mode checkbox in the top right-hand corner is checked.
  4. Click Load unpacked extension… to pop up a file selection dialog.
  5. Navigate to src in the extension directory, and select it.
  6. Visit any page on GOV.UK.

Source: Getting Started: Building a Chrome Extension.

For Firefox:

Extensions installed using the following instructions are only active while Firefox is open and are removed on exit. Permanently-active extensions can be only be installed from packages signed by Mozilla.

  1. Download the source from GitHub and unzip.
  2. Visit about:debugging in your browser.
  3. Click Load Temporary Add-on to pop up a file selection dialog.
  4. Navigate to src in the extension directory, and select manifest.json.
  5. Visit any page on GOV.UK.

Source: Temporary installation in Firefox.

Running the tests

In development, it's easiest to run:

$ bundle exec rake jasmine

This will start a server on http://localhost:8888/ that serves the tests.

You can also run the Jasmine test suite in slower "headless" mode with:

$ bundle exec rake jasmine:ci

Releasing the extension

  1. Update the version in manifest.json
  2. Run rake build
  3. Upload newly created package in /build to the Chrome web store (currently on Tijmen's account) and AMO (account details in the 2nd line password store)
  4. Create a new release on GitHub

License

MIT License