Need help with frontend?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

guardian
5.6K Stars 558 Forks Other 97.1K Commits 79 Opened issues

Description

The Guardian DotCom.

Services available

!
?

Need anything else?

Contributors list

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.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.