Templates

At BuboBox we provide a few default templates (you might have seen them while creating your challenges,) but sometimes that’s just not powerfull enough for you. This page will show you how to take your challenge to the next level with our ultra-customisable templating system. Please note this article is mostly meant for developers and assumes a basic understanding of web development as well as command-line usage.

Prerequisites

Before we get started, make sure you have installed node.js as well as grunt-cli. If you don’t know what we’re talking about here, take a look at the Node.js homepage and the Grunt getting started article to get you started.

Getting started

We made a video for you that goes through the process of making your own template, take a look and if something’s not clear, just leave us a message with the feedback tool on the left of this page!

Grunt deploy

The grunt deploy command at the end of this video will deploy your template onto an Amazon S3 bucket. If you want to use the S3 deploy that will upload your template to S3 you first need to create a file in your root with name aws.json. Now add following content and update the settings to match your deploy bucket and destination.

{
    "access-key": "AK.......",
    "secret-key": "......",
    "region": "us-east-1",
    "bucket": "bucket-name",
    "bucket-dest": "mypath/",
    "bucketUrl": "http://bucket-name.s3.amazonaws.com/"
}

No S3 bucket? After running the grunt template command, your ready-to-use template will be in the dist folder of your template. You can upload the contents of this folder to basically any location on the web and still use your template, as long as it’s publicly accessible. Just put the url to your template.xml file into “Advanced custom template” section when you’re creating a challenge.