frontend
frontend copied to clipboard
alphagov
Serves the homepage, transactions and some index pages on GOV.UK
Frontend
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
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://www.gov.uk/government/placeholder
- 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
Misc
| URL | Related views |
|---|---|
| http://www.gov.uk/school-term-holiday-dates http://www.gov.uk/pay-council-tax http://www.gov.uk/find-covid-19-lateral-flow-test-site http://www.gov.uk/rubbish-collection-day http://www.gov.uk/apply-council-tax-reduction http://www.gov.uk/apply-for-disabled-bus-pass http://www.gov.uk/apply-free-school-meals |
_base_page local_transaction/search |
| http://www.gov.uk/register-offices http://www.gov.uk/ukonline-centre-internet-access-computer-training http://www.gov.uk/find-theory-test-centre http://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
- alphagov/static - provides shared templates, styles, and JavaScript
- alphagov/content-store - provides raw data for rendering formats
- alphagov/locations-api - provides postcode lookups
- alphagov/imminence - 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 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 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
alphagov