Source for theguardian.com
HTML JavaScript Scala CSS Shell Java
Latest commit 3f64564 Aug 26, 2016 @regiskuckaertz regiskuckaertz committed on GitHub Merge pull request #14136 from guardian/rk-allowed-hosts
Messenger: Allow ads running on the local domain
Permalink
Failed to load latest commit information.
.github Put contributing guideline hint in html comment Apr 21, 2016
admin-jobs Revert "Revert "Merge pull request #13860 from guardian/tbonnin-injec… Aug 4, 2016
admin Modify references to teamcity host Aug 25, 2016
applications make path Option[String] Aug 25, 2016
archive Add GA tracking to 404 page Aug 24, 2016
article Enable email format for all LiveBlogs, including Minute pages (#14110) Aug 26, 2016
commercial Merge branch 'master' of github.com:guardian/frontend into rk-rejig-c… Aug 26, 2016
common Enable email format for all LiveBlogs, including Minute pages (#14110) Aug 26, 2016
data add test fixtures for live blog tests Aug 24, 2016
dev-build Enable email format for all LiveBlogs, including Minute pages (#14110) Aug 26, 2016
dev Change the custom dotcom:static build to use new format Aug 16, 2016
diagnostics PR feedback Aug 16, 2016
discussion Return error during get comment process Aug 22, 2016
docs Modify references to teamcity host Aug 25, 2016
facia-press Remove use of WS in Healthcheck Jul 28, 2016
facia fix compile errors from bad auto merge Aug 19, 2016
git-hooks Fix pre-commit hook to generate docs Table of Content Aug 9, 2016
grunt-configs Fix tests Aug 26, 2016
identity Make The Fiver remember you (#14075) Aug 23, 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 Remove unused import Aug 24, 2016
preview stop tests needing secrets Aug 18, 2016
project Revert "Revert "Config from S3"" Aug 24, 2016
router migrate router Jul 15, 2016
rss Remove use of WS in Healthcheck Jul 28, 2016
sanity-tests/test Changed trait to sealed trait Jun 24, 2014
sport Revert "Revert "Config from S3"" Aug 24, 2016
standalone Revert "Revert "Merge pull request #13860 from guardian/tbonnin-injec… Aug 4, 2016
static Merge pull request #14136 from guardian/rk-allowed-hosts Aug 26, 2016
tools add live blog and sport live blog to amp tests Aug 24, 2016
training-preview stop tests needing secrets Aug 18, 2016
.editorconfig just trying this out Jul 28, 2015
.eslintrc lint Jul 13, 2016
.gitignore Remove Vagrant Aug 12, 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 remove flash media player Jul 20, 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 Merge branch 'master' of github.com:guardian/frontend into de-ts Jul 13, 2016
npm-shrinkwrap.json Clean shrinkwrap Aug 18, 2016
package.json Remove shoe, shrinkwrap auto updated Aug 18, 2016
sbt Remove more ruby/bundle references Mar 22, 2016
setup.sh Revert "Revert "Config from S3"" Aug 24, 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.