Skip to content


Repository files navigation


Frontend renders the citizen-facing part of formats stored in the Content Store, and some hard-coded routes including the GOV.UK homepage.

Live examples


Simple smart answer

Transaction start pages:

Hard-coded routes

Licence finders



URL Related views
place/show publication_metadata
show flow _publication_metadata


  • format: our phrase for a type of content
  • scope: each type of calendar (eg daylight saving, bank holidays) is known as a scope. A scope has its own view templates, JSON data source and primary route.

Technical documentation

Frontend is a Ruby on Rails application and should follow our Rails app conventions.


Running the application

You can use the GOV.UK Docker environment or the local script to run the app. Read the guidance on local frontend development to find out more about each approach, before you get started.

If you are using GOV.UK Docker, remember to combine it with the commands that follow. See the GOV.UK Docker usage instructions for examples.

If you are using the script, first run static and execute the following command:


which uses a local copy of static and content from production.

Note that you will have to have GOV.UK Locations API running locally. A valid dataset will have to be loaded for Locations API or postcode lookups will not succeed. This is part of the standard GOV.UK data replication steps.

Running the test suite

bundle exec rake

Further documentation


MIT Licence