Application: government-frontend

Serves government pages on GOV.UK

• GitHub: government-frontend
• Ownership: #govuk-platform-health
• Hosting: AWS, on the draft_frontend machine class
• Continuously deployed?: Yes
• Rake tasks: Run a Rake task on Integration, Staging or ⚠️ Production ⚠️
• Links:
  • Sentry (error tracking)
  • Puppet configuration
  • Deploy scripts
  • Deployment dashboard
  • Publishing E2E scenarios (warning: not all apps have E2E tests)
  • Component guide

Relevant manual pages

• Add an organisation’s brand colour

Imported documents

• Visual regression tests
• Webchat Component

Example pages published by government-frontend

• History of Lancaster House (FCDO)
• History of 10 Downing Street
• History of the UK government
• History of King Charles Street (FCDO)
• History of 1 Horse Guards Road
• History of 11 Downing Street

Example pages rendered by government-frontend

• HMRC services: sign in or register
• Get a free PCR test to check if you have coronavirus (COVID-19)
• Entering the UK
• Universal Credit
• Spain travel advice
• Pay the Dartford Crossing charge (Dart Charge)
• France travel advice
• Greece travel advice
• National Minimum Wage and National Living Wage rates
• Change the address on your driving licence

README

Government Frontend is a public-facing app to display the majority of documents on the /government part of GOV.UK, which are fetched from the Content Store. It is a replacement for the public-facing parts of the Whitehall application.

Schemas

Not all schemas that this app can handle are rendered by it in production.

Schema	Live example	Production status
Answer	View on GOV.UK	Migrated
Case study	View on GOV.UK	Migrated
Coming soon		Migrated
Consultation	View on GOV.UK	Migrated
Contacts	View on GOV.UK	Migrated
Corporate information page	View on GOV.UK	Migrated
Detailed guide	View on GOV.UK	Migrated
Document collection	View on GOV.UK	Migrated
Fatality notice	View on GOV.UK	Migrated
Help page	View on GOV.UK	Migrated
HTML Publication	View on GOV.UK	Migrated
Guide	View on GOV.UK	Migrated
News Article	View on GOV.UK	Migrated
Publication	View on GOV.UK	Migrated
Specialist document	View on GOV.UK	Migrated
Statistics announcement	View on GOV.UK	Migrated
Statistical data set	View on GOV.UK	Migrated
Speech	View on GOV.UK	Migrated
Take part	View on GOV.UK	Migrated
Topical event about page	View on GOV.UK	Migrated
Travel advice	View on GOV.UK	Migrated
Unpublishing		Rendered by Whitehall, might not be migrated
World Location News Article	View on GOV.UK	Migrated
Working group	View on GOV.UK	Migrated

Technical documentation

This is a Ruby on Rails app, and should follow our Rails app conventions.

You can use the GOV.UK Docker environment or the local startup.sh 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.

Running the test suite

bundle exec rake

Components

Pages are rendered using components. Components can be specific to government-frontend or shared between applications.

Components specific to government-frontend are within the application and follow rules set out by the govuk_publishing_components gem. They are documented in the government-frontend component guide.

Further documentation

• Visual regression tests
• Webchat

Licence

MIT License