Ho Ho Ho
The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:
If you'd like to learn more about the engineering that goes into Santa Tracker, and how Santa Tracker works offline as a Progressive Web App, please check out Santa Tracker as a PWA.
In the 2016 version of Santa Tracker, some featured changes include-
Santa Tracker supports Chrome, Firefox, and Edge; it also supports IE11, Safari 9+ and Chromium-based browsers (Opera, Samsung etc) at m44 or above.
npm install -g bowerif it's missing) and Java available on your system.
Clone project, then from within the repo:
$ npm install
For a list of commands, run
Build and run with
You can load scenes (even while locked) via their ID, e.g. at
/#codeboogie. Alternatively, unlock houses (in dev) by calling
If you'd like to serve another way, then you can build all development dependencies with
First, build for prod and set a
baseurlfor static assets:
gulp dist --baseurl="http://localhost:9000/"
serve -p 3000 dist_prod/
Separately, serve the static resources:
serve -p 9000 --cors dist_static/
gulp dist --prettyto build. This performs additional steps, such as vulcanizing code and internationalization. Serve from
docker build -t santa .
docker create --restart always -p 8080:8080 --name santa santa
docker start -d santa
curl -I http://lg-head:8080
To rebuild, run
docker rm -f santaand start over from building the image.
Santa Tracker is comprised shared code along with many individual scenes: e.g.,
Scenes are referenced in a few locations-
scenes.js: The definition for each scene is contained here. If an
entryPointis specified, then the scene is compiled with the Closure Compiler. This is also used as the reference for the HTML fanout, creating a HTML file per scene, per language.
images/og: The OG image (for sharing) in the form
images/og/sceneName.png, and have a resolution of 1333x1000.
images/scenes: Each scene should have two images, the centered and resized version of the OG image-
elements/santa-strings.html: Due to inconsistent scene i18n message IDs, each scene needs to have its name declared here for dynamic string loading at runtime.
There are two optional locations-
scenes/dorf/sass/_houses.scss: If the scene is also a house that lives in the village.
scenes/press/js/models.js: To be included in the Press and Educators scenes.
All image and audio files (including *.png, *.jpg, *.svg, *.mp3, *.wav and *.ogg) are licensed under the CC-BY-NC license. All other files are licensed under the Apache 2 license. See the LICENSE file for details.
Copyright 2015 Google Inc. All rights reserved.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.