Getting Started

Find our tutorial, starter project and sampled software here!


We stepped into to the world of Augmented Reality (AR) when we chanced upon the Facebook AR Hackathon earlier this year. As new players in the field, we are grateful for the tutorials available on the Spark AR learning platform as they were comprehensive and easy to follow for beginners like us. However, we wished there were more advanced tutorials that can teach us on how to integrate the different features we have learnt together.

Therefore, we decided to pay it forward and come up with a step-by-step tutorial that teaches our readers on how to create an AR puzzle game using the Spark AR Studio. At the same time, we hope to generate interest in the AR field among more technology enthusiasts.

What it does

The tutorial covers various features available on the Spark AR Studio. It also covers basic JavaScript that will help to bring the game alive. Through a simplified version of Pirate Dash 360 - the game we have created for the Facebook AR Hackathon - we hope to impart our readers with transferable skills that they can use for their future AR application development. Ultimately, we hope that they can use the concepts that they have learnt to create more games and filters for everyone to enjoy.

The tutorial is mainly designed for developers with some programming background, as the learning curve for the scripting portion can be pretty steep.

How we wrote it

Our team made sure every part of the tutorial connects well to each other, and no steps were skipped in between. We angled the tutorial to fit those who are just starting on AR, by ensuring that there are meaningful diagrams and screenshots that could help them to understand the concepts better. We also included useful links and references that readers can refer to when they want to understand a particular subject matter better.

Importantly, we included sample solutions after every part, so that readers can check on their progress and ensure that they are on the right track. We believe this will be helpful to our readers especially in a self-learning environment, where they might not be able to readily get guidance firsthand.

In addition, we made sure that the concepts introduced are transferable and our readers can use the skills learnt for their own development work.

Challenges we ran into

It was not easy to explain what we have done concisely in a tutorial. To ensure that our tutorial is straightforward and simple to follow, we ran through the tutorial a couple of times, and even asked our friends to try it out. From there, we received meaningful feedback that has helped us to improve the clarity and quality of the tutorial.

We also figured that it is not possible to fit our entire game into the tutorial. As a result, we have taken only a simplified version of it as the reference used for the tutorial. Nonetheless, we have included the more challenging parts and given our readers hints on how they can go about to accomplish those tasks.

Accomplishments that we’re proud of

We are delighted over our end product, which we believe will be helpful to our readers who are starting on AR. At the same time, through coming up with this tutorial, we did a cross-sharing of knowledge & skills and learnt so much from understanding the parts that we were not involved previously.

What we learned

Visiting our project again has given us fresh perspectives as we were able to able to view the project from an educator's point of view. Through asking ourselves questions like "what concepts can our readers take away from our project?", we were able to come up with our own learning points that has helped us to become better AR developers.

It is very important as developers to be able to explain our code. By coming up with this tutorial, we have a better understanding of our filter and were able to carry out effective knowledge transfer to our readers, so that they can use the concepts that they have learnt from us for their own development.

What's next

To make sure that our instructions and code continue to work with the latest version of Spark AR Studio, we will do a monthly review as a team to ensure that it is up to date.

Importantly, we hope to gather more feedback, especially from an international audience, on how we can further improve the quality of our tutorial. Importantly, we hope to impact the AR community by providing them with another avenue to learn and explore the technology.

Built With

Share this project: