Source for theguardian.com
HTML JavaScript Scala CSS Shell Java
Latest commit 74af0d8 Sep 23, 2016 @kelvin-chappell kelvin-chappell committed on GitHub Merge pull request #14434 from guardian/kc-remove-logo-dims
Remove dimensions from logos
Permalink
Failed to load latest commit information.
.github Update the AMP instructions with how to run the test suite Sep 14, 2016
admin-jobs deploy.json: Set publicReadAcl to false and remove not needed parameters Sep 19, 2016
admin Radiator: Fix missing charts css class Sep 23, 2016
applications Merge branch 'master' into interactive-iframes Sep 21, 2016
archive deploy.json: Set publicReadAcl to false and remove not needed parameters Sep 19, 2016
article Add AMP data-loading-strategy attribute, "prefer-viewability-over-views" Sep 23, 2016
commercial Merge pull request #14433 from guardian/hosted-youtube-video Sep 23, 2016
common Merge pull request #14434 from guardian/kc-remove-logo-dims Sep 23, 2016
data add test Sep 20, 2016
dev-build Add JSON endpoint for native books component Sep 22, 2016
dev Change the custom dotcom:static build to use new format Aug 16, 2016
diagnostics deploy.json: Set publicReadAcl to false and remove not needed parameters Sep 19, 2016
discussion deploy.json: Set publicReadAcl to false and remove not needed parameters Sep 19, 2016
docs Merge pull request #14413 from guardian/gt-dk-google-analytics-docs Sep 22, 2016
facia-press deploy.json: Set publicReadAcl to false and remove not needed parameters Sep 19, 2016
facia Merge pull request #14397 from guardian/rk-remove-dfp-badges Sep 20, 2016
git-hooks Fix pre-commit hook to generate docs Table of Content Aug 9, 2016
grunt-configs Add cache option to eslint Sep 7, 2016
identity Merge pull request #14364 from guardian/tbonnin-fix-deploy-json Sep 20, 2016
integrated-tests fronts.gutools is updated so reinstating the test Oct 13, 2015
nginx Add proxy pass and referer for idapi Apr 19, 2016
onward Merge pull request #14396 from guardian/kc-onward-container Sep 21, 2016
preview deploy.json: Set publicReadAcl to false and remove not needed parameters Sep 19, 2016
project Add logo dimensions to branding model Sep 21, 2016
router deploy.json: Set publicReadAcl to false and remove not needed parameters Sep 19, 2016
rss deploy.json: Set publicReadAcl to false and remove not needed parameters Sep 19, 2016
sanity-tests/test Changed trait to sealed trait Jun 24, 2014
sport Update mobile apps api when changing competitions Sep 22, 2016
standalone Inject ContentApiClient into Index trait Sep 16, 2016
static Merge pull request #14431 from guardian/sa-inline-editionalisation Sep 23, 2016
tools Add a big error message if article isn't running Sep 15, 2016
training-preview deploy.json: Set publicReadAcl to false and remove not needed parameters Sep 19, 2016
.editorconfig just trying this out Jul 28, 2015
.eslintrc lint Jul 13, 2016
.gitignore Update grunt-eslint Sep 7, 2016
.nvmrc actaully let's go to 6 Jun 28, 2016
.sass-lint.yml Remove linter config Jul 19, 2016
Dockerfile-dev Force pulling the docker image and make install at startup Aug 18, 2016
Gruntfile.js Fix concat on undefined bug for coverage task Sep 5, 2016
LICENSE Update license year range to 2016 Jan 18, 2016
README.md Update the main README Aug 9, 2016
cla-corporate.txt Add Contributor License Agreements to the project Apr 19, 2013
cla-individual.txt Add Contributor License Agreements to the project Apr 19, 2013
dev.sh Silence ECR login command Aug 18, 2016
docker-compose.yml Add possibility to run container in watch mode and overwrite port map… Aug 18, 2016
docker-dev-startup.sh Force pulling the docker image and make install at startup Aug 18, 2016
grunt-tc Remove ruby teamcity tasks Mar 22, 2016
makefile Use node process to handle dev build checks Sep 15, 2016
npm-shrinkwrap.json Update grunt-eslint Sep 7, 2016
package.json Update grunt-eslint Sep 7, 2016
sbt Remove more ruby/bundle references Mar 22, 2016
setup.sh Remove misleading setup.sh message Sep 7, 2016

README.md

Gitter

We're hiring!

Ever thought about joining us?
http://developers.theguardian.com/join-the-team.html

Frontend

The Guardian website frontend.

Frontend is a set of Play Framework 2 Scala applications.

Frontend is built in two parts, using Grunt for the client side asset build and SBT for the Play Framework backend.

Documentations

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.