Skip to main content

Application: frontend

Serves the homepage, transactions and some index pages on GOV.UK

GitHub
frontend
Ownership
#govuk-platform-health
Hosting
AWS, on the draft_frontend machine class
Rake tasks
Integration, Staging or ⚠️ Production ⚠️

Imported documents

Example pages published by frontend

Example pages rendered by frontend

README

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

Formats

Simple smart answer

Transaction start pages:

Hard-coded routes

Licence finders

Transaction done pages

Transaction done with survey pages

Standard survey:

Assisted digital satisfaction surveys:

Calendars

Misc

URL Related views
http://www.gov.uk/school-term-holiday-dateshttp://www.gov.uk/pay-council-taxhttp://www.gov.uk/find-covid-19-lateral-flow-test-sitehttp://www.gov.uk/rubbish-collection-dayhttp://www.gov.uk/apply-council-tax-reductionhttp://www.gov.uk/apply-for-disabled-bus-passhttp://www.gov.uk/apply-free-school-meals _base_page local_transaction/search
http://www.gov.uk/register-officeshttp://www.gov.uk/ukonline-centre-internet-access-computer-traininghttp://www.gov.uk/find-theory-test-centrehttp://www.gov.uk/id-scan-eu-settlement-scheme _base_pageplace/show
http://www.gov.uk/provide-journey-contact-details-before-travel-uk publication_metadata_base_pageshow
http://www.gov.uk/contact-the-dvla/y/ flow
http://www.gov.uk/check-a-passport-travel-europe _publication_metadata_base_pagetransaction/show
http://www.gov.uk/renew-driving-licence-at-70 http://www.gov.uk/check-mot-history http://www.gov.uk/mot-testing-service http://www.gov.uk/order-coronavirus-rapid-lateral-flow-tests http://www.gov.uk/check-legal-aid _base_pagetransaction/show

Nomenclature

  • 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.

Dependencies

Running the application

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.

If you are using the startup.sh script, first run statichttps://github.com/alphagov/static) and execute the following command:

PLEK_SERVICE_STATIC_URI=http://static.dev.gov.uk ./startup.sh --live

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

Note that you will have to have GOV.UK Mapit running locally. A valid dataset will have to be loaded for Mapit 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

Licence

MIT Licence