Skip to main content
Table of contents

Application: manuals-frontend

Serves manuals on GOV.UK


#govuk-platform-health owns the application and is responsible for updating its dependencies.


The production version of this application is hosted on AWS.

SSH Access (AWS)

gds govuk connect ssh -e integration draft_frontend
gds govuk connect ssh -e staging aws/draft_frontend
gds govuk connect ssh -e production aws/draft_frontend

Run a rake task

Example pages rendered by manuals-frontend


Warning The content below is pulled in directly from the repository.
Links might not function properly.


Front-end app for the manuals format on GOV.UK

Live examples



Installation and running

In a terminal, run:


or using bowler:

bowl manuals-frontend

If you are using the GDS development virtual machine then the application will be available on the host at

Running the tests

The test suite includes testing against govuk-content-schemas, so you will need a copy of this repo on your file system. By default this should be in a sibling directory to your project. Alternatively, you can specify their location with the GOVUK_CONTENT_SCHEMAS_PATH environment variable.

jasmine tests are mounted at

All tests can be run using bundle exec rake as well.

Viewing a manual

You can see the content design manual at

Publishing a manual on dev

Manuals are published using manuals-publisher to publish a manual run manuals-publisher (instructions here:, publish a manual, and you should then be able to view it on manuals-frontend. If you have replicated from preview recently then you should be able to see currently published manuals at[preview-slug] too.