Skip to content

guardian/frontend

Folders and files

NameName
Last commit message
Last commit date

Latest commit

f3980bf · Jan 13, 2025
Jan 13, 2025
Apr 10, 2024
Jun 27, 2017
Dec 18, 2024
Jan 9, 2025
Dec 18, 2024
Dec 18, 2024
Jul 17, 2024
Dec 19, 2024
Jan 13, 2025
Mar 18, 2024
Jan 7, 2025
Jun 26, 2024
Dec 18, 2024
Nov 19, 2024
Dec 18, 2024
Dec 18, 2024
Jun 26, 2024
Dec 18, 2024
May 1, 2024
Jan 7, 2025
Jan 7, 2025
Jan 10, 2025
Jun 25, 2018
Dec 18, 2024
Dec 18, 2024
Jan 7, 2025
Jun 26, 2024
Feb 26, 2024
Apr 29, 2024
Sep 2, 2024
Dec 9, 2024
Jul 10, 2024
May 1, 2024
Sep 2, 2024
May 13, 2024
Feb 15, 2024
Apr 11, 2024
Apr 4, 2018
Jan 2, 2020
May 13, 2021
Dec 15, 2020
Dec 18, 2024
Apr 19, 2013
Apr 19, 2013
Jul 14, 2022
Jun 26, 2024
Jun 26, 2024
Jan 9, 2025
Dec 12, 2023
Dec 18, 2024
May 16, 2024
Jul 8, 2021
Jan 27, 2021
Aug 2, 2018
Jun 12, 2017
Apr 27, 2023
Jun 20, 2023
Apr 8, 2024
Jun 20, 2023
Jan 9, 2025

Repository files navigation

We're hiring!

Ever thought about joining us? https://workforus.theguardian.com/careers/product-engineering/

Frontend

The Guardian website frontend.

For everybody who engages with our journalism, theguardian.com is an industry-best news website that is fast, accessible and easy to use. Unlike other ways of developing products, ours puts the audience first.

Frontend is a set of Play Framework 2 Scala applications. It is built in two parts, using make for the client side asset build and SBT for the Play Framework backend.

For Articles, Frontend's responsiblity is to build JSON to pass to the modern rendering service, Dotcom Rendering.

Core Development Principles (lines in the sand)

These principles apply to all requests on www.theguardian.com and api.nextgen.guardianapps.co.uk (our Ajax URL)

  • Every request can be cached and has an appropriate Cache-Control header set.
  • Each request may only perform one I/O operation on the backend. (you cannot make two calls to the content API or any other 3rd party)
  • The average response time of any endpoint is less than 500ms.
  • Requests that take longer than two seconds will be terminated.

Documentation

All documentation notes and useful items can be found in the docs folder.

New developers

Welcome! How to set up and run frontend.

To get set up, please follow the installation guide.

Fixes for common problems can be found here.

Please read the development tips document to learn about more about development process.

For our deployment process, see how to deploy.