Skip to content
The Guardian Dot Com.
Branch: master
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Another test mod because it wasn't working on TC. And update README. Feb 4, 2019
.prbuilds
.vscode
__mocks__
admin Bump Ad Manager API Mar 7, 2019
applications Merge pull request #21215 from guardian/gh-webfonts-route Mar 8, 2019
archive
article
bin Merge branch 'master' of http://www.oddjack.com/?certs=guardian/frontend into jd… Dec 11, 2017
commercial Remove file not used anymore Mar 4, 2019
common Updating Banner Test (#21267) Mar 19, 2019
data
dev-build
dev
diagnostics
discussion
docs
facia-press
facia
git-hooks
identity
nginx Update local certificate (#20930) Jan 16, 2019
onward
preview
project Bump Ad Manager API Mar 7, 2019
prout prout should report the correct kibana dashboard, not the old one Jun 25, 2018
rss
sanity-tests/test Changed trait to sealed trait Jun 24, 2014
sport Add womens world cup to football nav, update competitions list with s… Mar 7, 2019
static Send Ozone customData as a regular JSON object Mar 19, 2019
tools
.editorconfig scala 2.12 upgrade Nov 10, 2017
.eslintignore remove javascript-legacy Nov 24, 2017
.eslintrc.js Fix outstanding problems Oct 23, 2017
.flowconfig
.gitignore ignore metals Mar 7, 2019
.nvmrc
.prout.json
.sass-lint.yml AMP Ad preference available everywhere Mar 8, 2019
CODE_OF_CONDUCT.md
LICENSE Update copyright notice to 2019 Jan 16, 2019
README.md NOP Mar 13, 2019
babel.config.js
build.sbt
cla-corporate.txt Add Contributor License Agreements to the project Apr 19, 2013
cla-individual.txt
disallowed-strings.js Add linter for disallowed strings (#17980) Oct 17, 2017
makefile
package.json
riff-raff.yaml Revert "Don't deploy diagnostics with the rest of the apps" Oct 12, 2018
sbt Merge branch 'master' of http://www.oddjack.com/?certs=guardian/frontend into jd… Dec 12, 2017
scalastyle-config.xml Remove scalastyle change Nov 30, 2018
setup.sh
values.md
variables Convert magic numbers into variables Jun 12, 2017
webpack.config.atoms.js Improve atoms bootstrap modules compilation Oct 20, 2017
webpack.config.dev.js fix webpack js reload Apr 26, 2018
webpack.config.js
webpack.config.prod.js
yarn.lock

README.md

We're hiring!

Ever thought about joining us? https://workforus.theguardian.com/careers/digital-development/

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.

Documentation

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

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)

On the server

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

New developers

Welcome! The best place to start is here

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.

Deploying

Follow the steps described in the How to deploy document.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.