Application: frontend

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

• GitHub: frontend
• Ownership: #govuk-navigation-tech
• Category: Frontend apps
• Links:
  • Sentry (error tracking)
  • App dashboard: request rates, errors, durations
  • Kibana App Logs (Production, last 3 hours)
  • Kibana Worker Logs (Production, last 3 hours)
  • Argo CD (frontend)
  • Argo CD (draft-frontend)

Example pages rendered by frontend

• Sign in to your Universal Credit account
• View and prove your immigration status: get a share code
• Check the MOT history of a vehicle
• Get access to your online immigration status (eVisa)
• Get information about a company
• Tax your vehicle
• Check if a vehicle is taxed
• View or share your driving licence information
• Sign in to your childcare account
• Check the MOT status of a vehicle

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

• https://www.gov.uk/sold-bought-vehicle
• https://www.gov.uk/contact-the-dvla

Transaction start pages:

• https://www.gov.uk/register-to-vote
• https://www.gov.uk/vehicle-tax
• https://www.gov.uk/find-a-job

Help

• https://www.gov.uk/help/browsers

Get Involved

• https://www.gov.uk/government/get-involved

Hard-coded routes

• https://www.gov.uk/ (homepage)
• https://www.gov.uk/help (help index page)
• https://www.gov.uk/help/cookies
• https://www.gov.uk/help/ab-testing
• https://www.gov.uk/foreign-travel-advice (travel advice index page)
• https://www.gov.uk/find-local-council
• https://assets.publishing.service.gov.uk/government/placeholder (asset placeholder while attachments are virus-checked)
• https://www.gov.uk/roadmap (GOV.UK public facing roadmap)
• https://www.gov.uk/contact-electoral-registration-office (elections API)

Licence finders

• https://www.gov.uk/find-licences/premises-licence
• https://www.gov.uk/find-licences/temporary-events-notice
• https://www.gov.uk/find-licences/apply-skip-permit
• https://www.gov.uk/find-licences/street-collection-licence
• https://www.gov.uk/find-licences/zoo-licence
• https://www.gov.uk/find-licences/premises-licence-scotland
• https://www.gov.uk/find-licences/house-to-house-collection-licence
• https://www.gov.uk/find-licences/public-charitable-collection-permit-scotland
• https://www.gov.uk/find-licences/late-hours-catering-licence-scotland
• https://www.gov.uk/find-licences/food-business-registration
• https://www.gov.uk/find-licences/cooling-tower-notification
• https://www.gov.uk/find-licences/performing-animals-registration

Calendars

• https://www.gov.uk/bank-holidays
• https://www.gov.uk/when-do-the-clocks-change

Take Part

• https://www.gov.uk/government/get-involved/take-part/improve-your-social-housing

Travel Advice Country pages

• https://www.gov.uk/foreign-travel-advice/azerbaijan

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.

See the CONTRIBUTING guide for more information.

Dependencies

• alphagov/static - provides shared templates, styles, and JavaScript
• alphagov/content-store - provides raw data for rendering formats
• alphagov/locations-api - provides postcode lookups
• alphagov/places-manager - provides places lookups (e.g. for find-my-nearest)
• alphagov/publishing-api - this app sends data to the content-store

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

• Calendars
• Elections

Licence

MIT Licence